Get Recently Added Media

This API command is used to get all recently added media to a Plex server.

URL

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

Parameters

Return Status

Response

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

<?xml version="1.0" encoding="UTF-8"?>
<MediaContainer size="70" 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="1710434120" sortAsc="1" thumb="/:/resources/movie.png" title1="Movies" title2="Recently Added" viewGroup="movie" viewMode="131624">
    <Video ratingKey="293776" key="/library/metadata/293776" guid="plex://movie/5d7768257228e5001f1dccce" slug="the-godfather-part-iii" editionTitle="The Coppola Restoration" studio="Paramount" type="movie" title="The Godfather Part III" titleSort="Godfather 03" contentRating="R" summary="Follows Michael Corleone, now in his 60s, as he seeks to free his family from crime and find a suitable successor to his empire." rating="6.6" audienceRating="6.7" year="1990" tagline="All the power on earth can't change destiny." thumb="/library/metadata/293776/thumb/1710405033" art="/library/metadata/293776/art/1710405033" duration="10215285" originallyAvailableAt="1990-12-25" addedAt="1704040658" updatedAt="1710405033" audienceRatingImage="rottentomatoes://image.rating.upright" chapterSource="media" primaryExtraKey="/library/metadata/293778" ratingImage="rottentomatoes://image.rating.ripe">
        <Media id="359530" duration="10215285" bitrate="15938" width="1912" height="1080" aspectRatio="1.78" audioChannels="6" audioCodec="ac3" videoCodec="h264" videoResolution="1080" container="mkv" videoFrameRate="24p" videoProfile="high">
            <Part id="359932" key="/library/parts/359932/1704046025/file.mkv" duration="10215285" file="M:\Media\Movies\The Godfather Part III (1990)\The Godfather Part III (1990) [1080p h.264][AAC AC3 TrueHD]{edition-The Coppola Restoration}.mkv" size="21127533050" container="mkv" videoProfile="high" />
        </Media>
        <Genre tag="Drama" />
        <Genre tag="Thriller" />
        <Country tag="United States of America" />
        <Collection tag="The Godfather" />
        <Director tag="Francis Ford Coppola" />
        <Writer tag="Francis Ford Coppola" />
        <Writer tag="Mario Puzo" />
        <Role tag="Al Pacino" />
        <Role tag="Diane Keaton" />
        <Role tag="Talia Shire" />
    </Video>
    ...
</MediaContainer>

The XML returned provides a list of the all movies in a library that are unwatched for the user 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.

Video library (movies and other videos)

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.

Music

For music, the command will return a Directory element for each album.

Remarks

When using the command ensure that the 'A' in 'recentlyAdded' is in uppercase. A lowercase 'A' will return a 404 status code.

This API command will not return media added to a photo library. It will only return media from a movies, TV shows, music or other videos library.

Examples

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

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

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