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

NameDescription
ip_addressThe IP address of the Plex Media server.
plex_tokenThe Plex token.
idThe key associated with a movies library. This key can be found by calling the Libraries API command and looking for a movies library.

Return Status

HTTP CodeDescription
200Success - The request was successful.
401Unauthorized - The Plex token provided was not valid.

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.

MediaContainer Attributes
AttributeDescription
sizeThe number of libraries.
allowSync1 - allow syncing content.
0 - don't allow syncing content.
artBackground artwork used to represent the library.
identifierThe type of item.
librarySectionIDThe unique key associated with the library.
librarySectionTitleThe title of the library.
librarySectionUUIDUnique GUID identifier for the library.
mediaTagPrefixPrefix for the media tag.
mediaTagVersionMedia tag version.
Note: This could be a date and time value.
sortAsc1 - the library is sorted in ascending order.
0 - the library is sorted in descending order.
thumbThe thumbnail for the library.
title1The title of the library.
Note: This appears to be internally created, and can't be changed by the server owner.
title2A descriptive title for the library.
viewGroupThe group type used to view the library.
viewModeUnknown integer value.

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

Video Attributes
AttributeDescription
ratingKeyA key associated with the item.
keyThe relative URL of the item information.
guidThe unique identifier comprised of the Plex agent and item identifier for the agent.
studioThe name of the item studio.
typeThe type of media.
titleThe title of the item.
contentRatingThe content rating associated with the item.
summaryA summary of the item.
ratingThe rating for the item.
audienceRatingThe audience rating for the item.
skipCountThe skip count.
yearThe year the item was released.
taglineThe tagline associated with the item.
thumbThe thumbnail for the item.
artThe background artwork used to represent the item.
durationThe length of the item in milliseconds.
originallyAvailableAtThe original release date of the item.
addedAtThe date and time, in Unix time, the item was added to the library.
updatedAtThe date and time in epoch time, the item was updated in the library.
audienceRatingImageThe image associated with the audience rating.
chapterSourceThe chapter source type.
ratingImageThe image associated with the rating.

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.

Media Attributes
AttributeDescription
idUnique ID associated with the item.
durationThe length of the item in milliseconds.
bitrateThe bitrate of the item.
widthThe width of the item.
heightThe height of the item.
aspectRatioThe aspect ratio of the item.
audioChannelsThe number of audio channels.
audioCodecThe audio codec used to encode the audio.
videoCodecThe video codec used to encode the video.
videoResolutionThe video resolution.
containerThe item container.
videoFrameRateThe framerate standard used for the video.
audioProfileThe audio profile of the media.
videoProfileThe video profile of the media.
titleThe title of the item.

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.

Part Attributes
AttributeDescription
idUnique ID associated with the part.
keyThe unique relative path for the part that is used at its key.
durationThe length of the part in milliseconds.
fileThe file associated with the part.
sizeThe file size of the part.
audioProfileThe audio profile associated with the audio part.
containerThe type of media container.
videoProfileThe video profile associated with the video part.

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.

Genre Attributes
AttributeDescription
tagA genre of the movie.
Director Attributes
AttributeDescription
tagA director of the movie.
Writer Attributes
AttributeDescription
tagA writer for the movie
Country Attributes
AttributeDescription
tagA country of origin for the movie.
Collection Attributes
AttributeDescription
tagThe name of a collection containing the movie.
Role Attributes
AttributeDescription
tagThe name of a person with a role in the movie.

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
Subscribe
Display