Get All Movies

A library, such as movies or TV shows, can contain many items. This API command will return all movies for a specific library that is available on the Plex server.

URL

GET http://[IP address]:32400/library/sections/[Movies Library ID]/all?X-Plex-Token=[PlexToken]

Parameters

NameDescription
IP addressThe IP address of the Plex Media server.
PlexTokenThe temporary authentication Plex token.
Movies Library 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="217" 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="1641342384" sortAsc="1" thumb="/:/resources/movie.png" title1="Movies" title2="All Movies" viewGroup="movie" viewMode="131624">
    <Video ratingKey="65547" key="/library/metadata/65547" guid="com.plexapp.agents.imdb://tt0103639?lang=en" studio="Walt Disney Pictures" type="movie" title="Aladdin" contentRating="G" summary="Princess Jasmine grows tired of being forced to remain in the palace, so she sneaks out into the marketplace, in disguise, where she meets street-urchin Aladdin.  The couple falls in love, although Jasmine may only marry a prince.  After being thrown in jail, Aladdin becomes embroiled in a plot to find a mysterious lamp, with which the evil Jafar hopes to rule the land." rating="9.5" audienceRating="9.2" skipCount="1" year="1992" tagline="Wish granted!" thumb="/library/metadata/65547/thumb/1607616868" art="/library/metadata/65547/art/1607616868" duration="5423772" originallyAvailableAt="1992-11-25" addedAt="1450147195" updatedAt="1607616868" audienceRatingImage="rottentomatoes://image.rating.upright" chapterSource="mixed" ratingImage="rottentomatoes://image.rating.ripe">
        <Media id="73681" duration="5423772" bitrate="2412" videoProfile="high">
            <Part id="73812" key="/library/parts/73812/1450141780/file.mkv" duration="5423772" file="M:\Media\Movies\Aladdin (1992)\Aladdin (1992) [480p h.264][AAC AC3].mkv" size="1639520577" container="mkv" videoProfile="high" />
        </Media>
        <Genre tag="Animation" />
        <Genre tag="Adventure" />
        <Director tag="Ron Clements" />
        <Director tag="John Musker" />
        <Writer tag="Ted Elliott" />
        <Writer tag="Terry Rossio" />
        <Country tag="USA" />
        <Collection tag="Disney" />
        <Role tag="Scott Weinger" />
        <Role tag="Robin Williams" />
        <Role tag="Linda Larkin" />
    </Video>
    ...
</MediaContainer>

Remarks

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 for Movies
AttributeDescription
sizeThe number of movies in the library.
allowSync1 - allow syncing content from this library.
0 - don't allow syncing content from this library.
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 item.
Note: This appears to be internally created, and can't be changed by the server owner.
title2A description 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 movie.
keyThe relative URL of the movie information.
guidThe unique identifier comprised of the Plex agent and movie identifier for the agent.
studioThe name of the movie studio.
typeThe type of media.
titleThe title of the movie.
contentRatingThe content rating associated with the movie.
summaryA summary of the movie.
ratingThe rating for the movie.
audienceRatingThe audience rating for the movie.
skipCountThe skip count.
yearThe year the movie was released.
taglineThe tagline associated with the movie.
thumbThe thumbnail for the movie.
artThe background artwork used to represent the movie.
durationThe length of the movie in milliseconds.
originallyAvailableAtThe original release date of the movie.
addedAtThe date and time the movie was added to the library.
updatedAtThe date and time the movie was updated in the library.
audienceRatingImageThe image associated with the audience rating.
chapterSourceThe chapter source type.
audienceRatingImageThe 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 media.
durationThe length of the media in milliseconds.
bitrateThe bitrate of the media.
videoProfileThe video profile of the media.

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.
containerThe type of media container.
videoProfileThe video profile associated with the movie 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.

Examples

Example 1

Get the list of all movies from the library associated with ID 2 on the Plex Media Server located at the IP address of 192.168.1.4:

GET http://192.168.1.4:32400/library/sections/2/all?X-Plex-Token=L6vkd7JtLHjsH5987vYY