GET
/
hubs
/
home
/
recentlyAdded
declare(strict_types=1);

require 'vendor/autoload.php';

use LukeHagar\Plex_API;
use LukeHagar\Plex_API\Models\Operations;

$sdk = Plex_API\PlexAPI::builder()
    ->setSecurity(
        '<YOUR_API_KEY_HERE>'
    )
    ->build();

$request = new Operations\GetRecentlyAddedRequest(
    contentDirectoryID: 470161,
    sectionID: 2,
    type: Operations\Type::TvShow,
);

$response = $sdk->hubs->getRecentlyAdded(
    request: $request
);

if ($response->object !== null) {
    // handle response
}
{
  "MediaContainer": {
    "size": 50,
    "offset": 123,
    "totalSize": 123,
    "identifier": "com.plexapp.plugins.library",
    "allowSync": false,
    "Meta": {
      "Type": [
        {
          "key": "/library/sections/2/all?type=2",
          "type": "filter",
          "subtype": "clip",
          "title": "TV Shows",
          "active": false,
          "Filter": [
            {
              "filter": "genre",
              "filterType": "string",
              "key": "/library/sections/2/genre?type=2",
              "title": "Genre",
              "type": "filter",
              "advanced": true
            }
          ],
          "Sort": [
            {
              "default": "asc",
              "active": false,
              "activeDirection": "asc",
              "defaultDirection": "asc",
              "descKey": "titleSort:desc",
              "firstCharacterKey": "/library/sections/2/firstCharacter",
              "key": "titleSort",
              "title": "Title"
            }
          ],
          "Field": [
            {
              "key": "show.title",
              "title": "Show Title",
              "type": "string",
              "subType": "rating"
            }
          ]
        }
      ],
      "FieldType": [
        {
          "type": "tag",
          "Operator": [
            {
              "key": "=",
              "title": "is"
            }
          ]
        }
      ]
    },
    "Metadata": [
      {
        "ratingKey": "58683",
        "key": "/library/metadata/58683",
        "guid": "plex://movie/5d7768ba96b655001fdc0408",
        "studio": "20th Century Studios",
        "skipChildren": false,
        "librarySectionID": 1,
        "librarySectionTitle": "Movies",
        "librarySectionKey": "/library/sections/1",
        "type": "movie",
        "title": "Avatar: The Way of Water",
        "slug": "4-for-texas",
        "contentRating": "PG-13",
        "summary": "Jake Sully lives with his newfound family formed on the extrasolar moon Pandora. Once a familiar threat returns to finish what was previously started, Jake must work with Neytiri and the army of the Na'vi race to protect their home.",
        "rating": 7.6,
        "audienceRating": 9.2,
        "year": 2022,
        "seasonCount": 2022,
        "tagline": "Return to Pandora.",
        "flattenSeasons": "1",
        "episodeSort": "0",
        "enableCreditsMarkerGeneration": "-1",
        "showOrdering": "absolute",
        "thumb": "/library/metadata/58683/thumb/1703239236",
        "art": "/library/metadata/58683/art/1703239236",
        "banner": "/library/metadata/58683/banner/1703239236",
        "duration": 11558112,
        "originallyAvailableAt": "2022-12-14T00:00:00.000Z",
        "addedAt": 1556281940,
        "updatedAt": 1556281940,
        "audienceRatingImage": "rottentomatoes://image.rating.upright",
        "chapterSource": "media",
        "primaryExtraKey": "/library/metadata/58684",
        "ratingImage": "rottentomatoes://image.rating.ripe",
        "grandparentRatingKey": "66",
        "grandparentGuid": "plex://show/5d9c081b170e24001f2a7be4",
        "grandparentKey": "/library/metadata/66",
        "grandparentTitle": "Caprica",
        "grandparentThumb": "/library/metadata/66/thumb/1705716261",
        "parentSlug": "alice-in-borderland-2020",
        "grandparentSlug": "alice-in-borderland-2020",
        "grandparentArt": "/library/metadata/66/art/1705716261",
        "grandparentTheme": "/library/metadata/66/theme/1705716261",
        "Media": [
          {
            "id": 119534,
            "duration": 11558112,
            "bitrate": 25025,
            "width": 3840,
            "height": 2072,
            "aspectRatio": 1.85,
            "audioProfile": "dts",
            "audioChannels": 6,
            "audioCodec": "eac3",
            "videoCodec": "hevc",
            "videoResolution": "4k",
            "container": "mkv",
            "videoFrameRate": "24p",
            "videoProfile": "main 10",
            "hasVoiceActivity": false,
            "optimizedForStreaming": 1,
            "has64bitOffsets": false,
            "Part": [
              {
                "id": 119542,
                "key": "/library/parts/119542/1680457526/file.mkv",
                "duration": 11558112,
                "file": "/movies/Avatar The Way of Water (2022)/Avatar.The.Way.of.Water.2022.2160p.WEB-DL.DDP5.1.Atmos.DV.HDR10.HEVC-CMRG.mkv",
                "size": 36158371307,
                "container": "mkv",
                "audioProfile": "dts",
                "has64bitOffsets": false,
                "optimizedForStreaming": false,
                "videoProfile": "main 10",
                "indexes": "sd",
                "hasThumbnail": "1",
                "Stream": [
                  {
                    "id": 272796,
                    "streamType": 1,
                    "default": true,
                    "selected": true,
                    "codec": "h264",
                    "index": 0,
                    "bitrate": 6273,
                    "colorPrimaries": "bt709",
                    "colorRange": "tv",
                    "colorSpace": "bt709",
                    "colorTrc": "bt709",
                    "bitDepth": 8,
                    "chromaLocation": "left",
                    "streamIdentifier": "2",
                    "chromaSubsampling": "4:2:0",
                    "codedHeight": 1088,
                    "codedWidth": 1920,
                    "frameRate": 29.97,
                    "hasScalingMatrix": false,
                    "hearingImpaired": false,
                    "closedCaptions": false,
                    "embeddedInVideo": "1",
                    "height": 1080,
                    "level": 40,
                    "profile": "main",
                    "refFrames": 4,
                    "scanType": "progressive",
                    "width": 1920,
                    "displayTitle": "1080p (H.264)",
                    "extendedDisplayTitle": "1080p (H.264)",
                    "channels": 2,
                    "language": "English",
                    "languageTag": "en",
                    "languageCode": "eng",
                    "audioChannelLayout": "stereo",
                    "samplingRate": 48000,
                    "title": "English",
                    "canAutoSync": false
                  }
                ]
              }
            ]
          }
        ],
        "Genre": [
          {
            "tag": "Adventure"
          }
        ],
        "Country": [
          {
            "tag": "United States of America"
          }
        ],
        "Director": [
          {
            "tag": "James Cameron"
          }
        ],
        "Writer": [
          {
            "tag": "James Cameron"
          }
        ],
        "Collection": [
          {
            "tag": "Working NL Subs"
          }
        ],
        "Role": [
          {
            "id": 294129,
            "filter": "actor=294129",
            "thumb": "https://metadata-static.plex.tv/2/people/27b85844536c39f3f9ac943aaad46608.jpg",
            "tag": "Mike Smith",
            "tagKey": "668e7e7b22bcad9064350c91",
            "role": "Self"
          }
        ],
        "Location": [
          {
            "path": "/TV Shows/House"
          }
        ],
        "Guid": [
          {
            "id": "imdb://tt13015952"
          }
        ],
        "UltraBlurColors": {
          "topLeft": "11333b",
          "topRight": "0a232d",
          "bottomRight": 73958,
          "bottomLeft": "1f5066"
        },
        "Rating": [
          {
            "image": "themoviedb://image.rating",
            "value": 3,
            "type": "audience"
          }
        ],
        "Image": [
          {
            "alt": "Episode 1",
            "type": "background",
            "url": "/library/metadata/45521/thumb/1644710589"
          }
        ],
        "titleSort": "Whale",
        "viewCount": 1,
        "lastViewedAt": 1682752242,
        "originalTitle": "映画 ブラッククローバー 魔法帝の剣",
        "viewOffset": 5222500,
        "skipCount": 1,
        "index": 1,
        "theme": "/library/metadata/1/theme/1705636920",
        "leafCount": 14,
        "viewedLeafCount": 0,
        "childCount": 1,
        "hasPremiumExtras": "1",
        "hasPremiumPrimaryExtra": "1",
        "parentRatingKey": "66",
        "parentGuid": "plex://show/5d9c081b170e24001f2a7be4",
        "parentStudio": "UCP",
        "parentKey": "/library/metadata/66",
        "parentTitle": "Caprica",
        "parentIndex": 1,
        "parentYear": 2010,
        "parentThumb": "/library/metadata/66/thumb/1705716261",
        "parentTheme": "/library/metadata/66/theme/1705716261"
      }
    ]
  }
}

Authorizations

​
X-Plex-Token
string
header
required

Plex Authentication Token

Query Parameters

​
contentDirectoryID
integer
required

The content directory ID.

​
pinnedContentDirectoryID
string

Comma-separated list of pinned content directory IDs.

​
sectionID
integer

The library section ID for filtering content.

Example:

2

​
type
enum<integer>
required

The type of media to retrieve or filter by. 1 = movie 2 = show 3 = season 4 = episode E.g. A movie library will not return anything with type 3 as there are no seasons for movie libraries

Available options:
1,
2,
3,
4,
8,
9,
10
Example:

2

​
includeMeta
enum<integer>
default:0

Adds the Meta object to the response

Available options:
0,
1
Example:

1

​
X-Plex-Container-Start
integer
default:0

The index of the first item to return. If not specified, the first item will be returned. If the number of items exceeds the limit, the response will be paginated. By default this is 0

Example:

0

​
X-Plex-Container-Size
integer
default:50

The number of items to return. If not specified, all items will be returned. If the number of items exceeds the limit, the response will be paginated. By default this is 50

Example:

50

Response

200
application/json

A successful response with recently added content.

The response is of type object.