Get Newest Movies

A library, such as movies or TV shows, can contain many items. This API command will return information about movies by the order in which they were released. The order of the movies is the newest to the oldest.

URL

GET http://{ip_address}:32400/library/sections/{id}/newest?X-Plex-Token={plex_token}

Parameters

Return Status

Response

XML string value that lists the all the movies in the library. An example of the XML returned from the request is shown below:

<?xml version="1.0" encoding="UTF-8"?>
<MediaContainer size="42" allowSync="1" art="/:/resources/movie-fanart.jpg" identifier="com.plexapp.plugins.library" librarySectionID="2" librarySectionTitle="Movies" librarySectionUUID="493a64e7-b541-4667-b050-d702beebf2f6" mediaTagPrefix="/system/bundle/media/flags/" mediaTagVersion="1675127862" sortAsc="1" thumb="/:/resources/movie.png" title1="Movies" title2="Recently Released" viewGroup="movie" viewMode="131624">
    <Video ratingKey="217704" key="/library/metadata/217704" guid="plex://movie/5d7769ff47dd6e001f6cd584" studio="Lucasfilm Ltd." type="movie" title="Star Wars: Episode IX - The Rise of Skywalker" titleSort="Star Wars 09" contentRating="PG-13" summary="In the riveting conclusion of the landmark Skywalker saga, new legends will be born-and the final battle for freedom is yet to come." rating="5.2" audienceRating="8.6" viewCount="1" lastViewedAt="1611698558" year="2019" tagline="Every generation has a legend" thumb="/library/metadata/217704/thumb/1675422252" art="/library/metadata/217704/art/1675422252" duration="8513034" originallyAvailableAt="2019-12-18" addedAt="1586033313" updatedAt="1675422252" audienceRatingImage="rottentomatoes://image.rating.upright" chapterSource="media" primaryExtraKey="/library/metadata/284375" ratingImage="rottentomatoes://image.rating.rotten">
        <Media id="277001" duration="8513034" bitrate="13574" width="1920" height="804" aspectRatio="2.35" audioChannels="8" audioCodec="dca-ma" videoCodec="h264" videoResolution="1080" container="mkv" videoFrameRate="24p" audioProfile="ma" videoProfile="high" title="Original">
            <Part id="277331" key="/library/parts/277331/1585988083/file.mkv" duration="8513034" file="M:\Media\Movies\Star Wars - Episode 9 (2019)\Star Wars - Episode 9 (2019) [1080p h.264][AAC DTS DTS-HD].mkv" size="14460683991" audioProfile="ma" container="mkv" videoProfile="high" />
        </Media>
        <Media id="277002" duration="8513054" bitrate="8960" width="1920" height="804" aspectRatio="2.35" audioChannels="6" audioCodec="aac" videoCodec="h264" videoResolution="1080" container="mp4" videoFrameRate="24p" optimizedForStreaming="1" proxyType="42" audioProfile="lc" has64bitOffsets="1" target="Optimized for TV" targetTagID="6208" videoProfile="high" title="Optimized for TV">
            <Part id="277332" key="/library/parts/277332/1586041096/file.mp4" duration="8513054" file="M:\Media\Movies\Star Wars - Episode 9 (2019)\Plex Versions\Optimized for TV\Star Wars_ The Rise of Skywalker (2019).mp4" size="9555743604" audioProfile="lc" container="mp4" has64bitOffsets="1" optimizedForStreaming="1" videoProfile="high" />
        </Media>
        <Media id="277003" duration="8513054" bitrate="3122" width="1280" height="536" aspectRatio="2.35" audioChannels="2" audioCodec="aac" videoCodec="h264" videoResolution="720" container="mp4" videoFrameRate="24p" optimizedForStreaming="1" proxyType="42" audioProfile="lc" has64bitOffsets="0" target="Optimized for Mobile" targetTagID="6207" videoProfile="high" title="Optimized for Mobile">
            <Part id="277333" key="/library/parts/277333/1586044380/file.mp4" duration="8513054" file="M:\Media\Movies\Star Wars - Episode 9 (2019)\Plex Versions\Optimized for Mobile\Star Wars_ The Rise of Skywalker (2019).mp4" size="3338774672" audioProfile="lc" container="mp4" has64bitOffsets="0" optimizedForStreaming="1" videoProfile="high" />
        </Media>
        <Genre tag="Action" />
        <Genre tag="Adventure" />
        <Director tag="J.J. Abrams" />
        <Writer tag="George Lucas" />
        <Writer tag="J.J. Abrams" />
        <Country tag="United States of America" />
        <Collection tag="Star Wars" />
        <Role tag="Carrie Fisher" />
        <Role tag="Mark Hamill" />
        <Role tag="Daisy Ridley" />
    </Video>
    <Video ratingKey="214970" key="/library/metadata/214970" guid="plex://movie/5d776cca7a53e9001e74c43f" studio="Vertigo Entertainment" type="movie" title="The Lego Movie 2: The Second Part" titleSort="Lego 02" contentRating="PG" summary="It's been five years since everything was awesome and the citizens are facing a huge new threat: Lego Duplo invaders from outer space, wrecking everything faster than they can rebuild." rating="8.4" audienceRating="6.8" year="2019" tagline="They come in pieces" thumb="/library/metadata/214970/thumb/1675422250" art="/library/metadata/214970/art/1675422250" duration="6429493" originallyAvailableAt="2019-02-06" addedAt="1561007022" updatedAt="1675422250" audienceRatingImage="rottentomatoes://image.rating.upright" chapterSource="media" primaryExtraKey="/library/metadata/283682" ratingImage="rottentomatoes://image.rating.ripe">
        <Media id="274316" duration="6429493" bitrate="6541" width="1920" height="804" aspectRatio="2.35" audioChannels="6" audioCodec="ac3" videoCodec="h264" videoResolution="1080" container="mkv" videoFrameRate="24p" videoProfile="high" title="Original">
            <Part id="274646" key="/library/parts/274646/1561004040/file.mkv" duration="6429493" file="M:\Media\Movies\The Lego Movie 2 The Second Part (2019)\The Lego Movie 2 The Second Part [1080p h.264][AAC AC3 DTS-HD].mkv" size="5265626703" container="mkv" videoProfile="high" />
        </Media>
        <Media id="274317" duration="6429492" bitrate="4966" width="1920" height="804" aspectRatio="2.35" audioChannels="6" audioCodec="ac3" videoCodec="h264" videoResolution="1080" container="mp4" videoFrameRate="24p" optimizedForStreaming="1" proxyType="42" has64bitOffsets="0" target="Optimized for TV" targetTagID="6208" videoProfile="high" title="Optimized for TV">
            <Part id="274647" key="/library/parts/274647/1561167430/file.mp4" duration="6429492" file="M:\Media\Movies\The Lego Movie 2 The Second Part (2019)\Plex Versions\Optimized for TV\The Lego Movie 2_ The Second Part (2019).mp4" size="4002185893" container="mp4" has64bitOffsets="0" optimizedForStreaming="1" videoProfile="high" />
        </Media>
        <Genre tag="Family" />
        <Genre tag="Science Fiction" />
        <Director tag="Mike Mitchell" />
        <Writer tag="Bob Kane" />
        <Writer tag="Jerry Siegel" />
        <Country tag="Australia" />
        <Country tag="United States of America" />
        <Collection tag="Lego" />
        <Role tag="Chris Pratt" />
        <Role tag="Elizabeth Banks" />
        <Role tag="Will Arnett" />
    </Video>
    ...
</MediaContainer>

The XML returned provides a list of the all movies in a library that are available on the Plex server. The root is the MediaContainer element. This element contains a few attributes that provide overall information about the movies on the server.

Within the MediaContainer there are one or more Video child elements. Each Video element represents one movie available on the Plex server.

Within the Video there are one or more Media child elements. Each Media element represents one media file of the movie available on the Plex server.

If there are two media files associated with the movie, such as a 1080p and 480p version, then there would be two Media child elements in the Video element.

Within the Media there are one or more Part child elements. Each Part element represents one part of the movie. If the movie has been added to the Plex server as a multi-part movie, then each of those parts will be represented by one Part child element.

Also within the Video element there are multiple additional child elements that provide more details about the movie. These child elements include Genre, Director, Writer, Country, Collection, and Role.

Within each of these child elements is a single tag attribute that provides the information for the element. There could be multiple of the same child element within the Video, such as multiple directors or writers.

Examples

curl -X GET http://{ip_address}:32400/library/sections/{id}/newest?X-Plex-Token={plex_token}

import requests
plex_url = http://{ip_address}:32400/library/sections/{id}/newest?X-Plex-Token={plex_token}
response = requests.get(plex_url)
print(response.text)

$response = Invoke-RestMethod 'http://{ip_address}:32400/library/sections/{id}/newest?X-Plex-Token={plex_token}' -Method 'GET'
Write-Output $response