plexphp/docs/sdks/library/README.md

Library

(library)

Overview

API Calls interacting with Plex Media Server Libraries

Available Operations

• getFileHash - Get Hash Value
• getRecentlyAddedLibrary - Get Recently Added
• getAllLibraries - Get All Libraries
• getLibraryDetails - Get Library Details
• deleteLibrary - Delete Library Section
• getLibraryItems - Get Library Items
• getLibrarySectionsAll - Get Library section media by tag ALL
• getRefreshLibraryMetadata - Refresh Metadata Of The Library
• getSearchLibrary - Search Library
• getGenresLibrary - Get Genres of library media
• getCountriesLibrary - Get Countries of library media
• getActorsLibrary - Get Actors of library media
• getSearchAllLibraries - Search All Libraries
• getMediaMetaData - Get Media Metadata
• getMediaArts - Get Media Background Artwork
• postMediaArts - Upload Media Background Artwork
• getMediaPosters - Get Media Posters
• postMediaPoster - Upload Media Poster
• getMetadataChildren - Get Items Children
• getTopWatchedContent - Get Top Watched Content

getFileHash

This resource returns hash values for local files

Example Usage

declare(strict_types=1);

require 'vendor/autoload.php';

use LukeHagar\Plex_API;

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



$response = $sdk->library->getFileHash(
    url: 'file://C:\Image.png&type=13'
);

if ($response->statusCode === 200) {
    // handle response
}

Parameters

Parameter	Type	Required	Description	Example
url	string	✔️	This is the path to the local file, must be prefixed by file://	file://C:\Image.png&type=13
type	?float	➖	Item type

Response

?Operations\GetFileHashResponse

Errors

Error Type	Status Code	Content Type
Errors\GetFileHashBadRequest	400	application/json
Errors\GetFileHashUnauthorized	401	application/json
Errors\SDKException	4XX, 5XX	*/*

getRecentlyAddedLibrary

This endpoint will return the recently added content.

Example Usage

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\GetRecentlyAddedLibraryRequest(
    contentDirectoryID: 2,
    pinnedContentDirectoryID: [
        3,
        5,
        7,
        13,
        12,
        1,
        6,
        14,
        2,
        10,
        16,
        17,
    ],
    sectionID: 2,
    type: Operations\QueryParamType::TvShow,
    includeMeta: Operations\QueryParamIncludeMeta::Enable,
);

$response = $sdk->library->getRecentlyAddedLibrary(
    request: $request
);

if ($response->object !== null) {
    // handle response
}

Parameters

Parameter	Type	Required	Description
$request	Operations\GetRecentlyAddedLibraryRequest	✔️	The request object to use for the request.

Response

?Operations\GetRecentlyAddedLibraryResponse

Errors

Error Type	Status Code	Content Type
Errors\GetRecentlyAddedLibraryBadRequest	400	application/json
Errors\GetRecentlyAddedLibraryUnauthorized	401	application/json
Errors\SDKException	4XX, 5XX	*/*

getAllLibraries

A library section (commonly referred to as just a library) is a collection of media. Libraries are typed, and depending on their type provide either a flat or a hierarchical view of the media. For example, a music library has an artist > albums > tracks structure, whereas a movie library is flat.

Libraries have features beyond just being a collection of media; for starters, they include information about supported types, filters and sorts. This allows a client to provide a rich interface around the media (e.g. allow sorting movies by release year).

Example Usage

declare(strict_types=1);

require 'vendor/autoload.php';

use LukeHagar\Plex_API;

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



$response = $sdk->library->getAllLibraries(

);

if ($response->object !== null) {
    // handle response
}

Response

?Operations\GetAllLibrariesResponse

Errors

Error Type	Status Code	Content Type
Errors\GetAllLibrariesBadRequest	400	application/json
Errors\GetAllLibrariesUnauthorized	401	application/json
Errors\SDKException	4XX, 5XX	*/*

getLibraryDetails

Library Details Endpoint

This endpoint provides comprehensive details about the library, focusing on organizational aspects rather than the content itself.

The details include:

Directories

Organized into three categories:

• Primary Directories:

  • Used in some clients for quick access to media subsets (e.g., "All", "On Deck").
  • Most can be replicated via media queries.
  • Customizable by users.

• Secondary Directories:

  • Marked with secondary="1".
  • Used in older clients for structured navigation.

• Special Directories:

  • Includes a "By Folder" entry for filesystem-based browsing.
  • Contains an obsolete search="1" entry for on-the-fly search dialog creation.

Types

Each type in the library comes with a set of filters and sorts, aiding in building dynamic media controls:

• Type Object Attributes:

  • key: Endpoint for the media list of this type.
  • type: Metadata type (if standard Plex type).
  • title: Title for this content type (e.g., "Movies").

• Filter Objects:

  • Subset of the media query language.
  • Attributes include filter (name), filterType (data type), key (endpoint for value range), and title.

• Sort Objects:

  • Description of sort fields.
  • Attributes include defaultDirection (asc/desc), descKey and key (sort parameters), and title.

Note

: Filters and sorts are optional; without them, no filtering controls are rendered.

Example Usage

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();



$response = $sdk->library->getLibraryDetails(
    sectionKey: 9518,
    includeDetails: Operations\IncludeDetails::Zero

);

if ($response->object !== null) {
    // handle response
}

Parameters

Parameter	Type	Required	Description	Example
sectionKey	int	✔️	The unique key of the Plex library. Note: This is unique in the context of the Plex server.	9518
includeDetails	?Operations\IncludeDetails	➖	Whether or not to include details for a section (types, filters, and sorts). Only exists for backwards compatibility, media providers other than the server libraries have it on always.

Response

?Operations\GetLibraryDetailsResponse

Errors

Error Type	Status Code	Content Type
Errors\GetLibraryDetailsBadRequest	400	application/json
Errors\GetLibraryDetailsUnauthorized	401	application/json
Errors\SDKException	4XX, 5XX	*/*

deleteLibrary

Delete a library using a specific section id

Example Usage

declare(strict_types=1);

require 'vendor/autoload.php';

use LukeHagar\Plex_API;

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



$response = $sdk->library->deleteLibrary(
    sectionKey: 9518
);

if ($response->statusCode === 200) {
    // handle response
}

Parameters

Parameter	Type	Required	Description	Example
sectionKey	int	✔️	The unique key of the Plex library. Note: This is unique in the context of the Plex server.	9518

Response

?Operations\DeleteLibraryResponse

Errors

Error Type	Status Code	Content Type
Errors\DeleteLibraryBadRequest	400	application/json
Errors\DeleteLibraryUnauthorized	401	application/json
Errors\SDKException	4XX, 5XX	*/*

getLibraryItems

Fetches details from a specific section of the library identified by a section key and a tag. The tag parameter accepts the following values:

• all: All items in the section.
• unwatched: Items that have not been played.
• newest: Items that are recently released.
• recentlyAdded: Items that are recently added to the library.
• recentlyViewed: Items that were recently viewed.
• onDeck: Items to continue watching.
• collection: Items categorized by collection.
• edition: Items categorized by edition.
• genre: Items categorized by genre.
• year: Items categorized by year of release.
• decade: Items categorized by decade.
• director: Items categorized by director.
• actor: Items categorized by starring actor.
• country: Items categorized by country of origin.
• contentRating: Items categorized by content rating.
• rating: Items categorized by rating.
• resolution: Items categorized by resolution.
• firstCharacter: Items categorized by the first letter.
• folder: Items categorized by folder.
• albums: Items categorized by album.

Example Usage

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\GetLibraryItemsRequest(
    tag: Operations\Tag::Newest,
    includeGuids: Operations\IncludeGuids::Enable,
    type: Operations\GetLibraryItemsQueryParamType::TvShow,
    sectionKey: 9518,
    includeMeta: Operations\GetLibraryItemsQueryParamIncludeMeta::Enable,
);

$response = $sdk->library->getLibraryItems(
    request: $request
);

if ($response->object !== null) {
    // handle response
}

Parameters

Parameter	Type	Required	Description
$request	Operations\GetLibraryItemsRequest	✔️	The request object to use for the request.

Response

?Operations\GetLibraryItemsResponse

Errors

Error Type	Status Code	Content Type
Errors\GetLibraryItemsBadRequest	400	application/json
Errors\GetLibraryItemsUnauthorized	401	application/json
Errors\SDKException	4XX, 5XX	*/*

getLibrarySectionsAll

Retrieves a list of all general media data for this library.

Example Usage

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\GetLibrarySectionsAllRequest(
    sectionKey: 9518,
    type: Operations\GetLibrarySectionsAllQueryParamType::TvShow,
    includeMeta: Operations\GetLibrarySectionsAllQueryParamIncludeMeta::Enable,
    includeGuids: Operations\QueryParamIncludeGuids::Enable,
    includeAdvanced: Operations\IncludeAdvanced::Enable,
    includeCollections: Operations\QueryParamIncludeCollections::Enable,
    includeExternalMedia: Operations\QueryParamIncludeExternalMedia::Enable,
);

$response = $sdk->library->getLibrarySectionsAll(
    request: $request
);

if ($response->object !== null) {
    // handle response
}

Parameters

Parameter	Type	Required	Description
$request	Operations\GetLibrarySectionsAllRequest	✔️	The request object to use for the request.

Response

?Operations\GetLibrarySectionsAllResponse

Errors

Error Type	Status Code	Content Type
Errors\GetLibrarySectionsAllBadRequest	400	application/json
Errors\GetLibrarySectionsAllUnauthorized	401	application/json
Errors\SDKException	4XX, 5XX	*/*

getRefreshLibraryMetadata

This endpoint Refreshes all the Metadata of the library.

Example Usage

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();



$response = $sdk->library->getRefreshLibraryMetadata(
    sectionKey: 9518,
    force: Operations\Force::Zero

);

if ($response->statusCode === 200) {
    // handle response
}

Parameters

Parameter	Type	Required	Description	Example
sectionKey	int	✔️	The unique key of the Plex library. Note: This is unique in the context of the Plex server.	9518
force	?Operations\Force	➖	Force the refresh even if the library is already being refreshed.	0

Response

?Operations\GetRefreshLibraryMetadataResponse

Errors

Error Type	Status Code	Content Type
Errors\GetRefreshLibraryMetadataBadRequest	400	application/json
Errors\GetRefreshLibraryMetadataUnauthorized	401	application/json
Errors\SDKException	4XX, 5XX	*/*

getSearchLibrary

Search for content within a specific section of the library.

Types

Each type in the library comes with a set of filters and sorts, aiding in building dynamic media controls:

• Type Object Attributes:

  • type: Metadata type (if standard Plex type).
  • title: Title for this content type (e.g., "Movies").

• Filter Objects:

  • Subset of the media query language.
  • Attributes include filter (name), filterType (data type), key (endpoint for value range), and title.

• Sort Objects:

  • Description of sort fields.
  • Attributes include defaultDirection (asc/desc), descKey and key (sort parameters), and title.

Note

: Filters and sorts are optional; without them, no filtering controls are rendered.

Example Usage

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();



$response = $sdk->library->getSearchLibrary(
    sectionKey: 9518,
    type: Operations\GetSearchLibraryQueryParamType::TvShow

);

if ($response->object !== null) {
    // handle response
}

Parameters

Parameter	Type	Required	Description	Example
sectionKey	int	✔️	The unique key of the Plex library. Note: This is unique in the context of the Plex server.	9518
type	Operations\GetSearchLibraryQueryParamType	✔️	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	2

Response

?Operations\GetSearchLibraryResponse

Errors

Error Type	Status Code	Content Type
Errors\GetSearchLibraryBadRequest	400	application/json
Errors\GetSearchLibraryUnauthorized	401	application/json
Errors\SDKException	4XX, 5XX	*/*

getGenresLibrary

Retrieves a list of all the genres that are found for the media in this library.

Example Usage

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();



$response = $sdk->library->getGenresLibrary(
    sectionKey: 9518,
    type: Operations\GetGenresLibraryQueryParamType::TvShow

);

if ($response->object !== null) {
    // handle response
}

Parameters

Parameter	Type	Required	Description	Example
sectionKey	int	✔️	The unique key of the Plex library. Note: This is unique in the context of the Plex server.	9518
type	Operations\GetGenresLibraryQueryParamType	✔️	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	2

Response

?Operations\GetGenresLibraryResponse

Errors

Error Type	Status Code	Content Type
Errors\GetGenresLibraryBadRequest	400	application/json
Errors\GetGenresLibraryUnauthorized	401	application/json
Errors\SDKException	4XX, 5XX	*/*

getCountriesLibrary

Retrieves a list of all the countries that are found for the media in this library.

Example Usage

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();



$response = $sdk->library->getCountriesLibrary(
    sectionKey: 9518,
    type: Operations\GetCountriesLibraryQueryParamType::TvShow

);

if ($response->object !== null) {
    // handle response
}

Parameters

Parameter	Type	Required	Description	Example
sectionKey	int	✔️	The unique key of the Plex library. Note: This is unique in the context of the Plex server.	9518
type	Operations\GetCountriesLibraryQueryParamType	✔️	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	2

Response

?Operations\GetCountriesLibraryResponse

Errors

Error Type	Status Code	Content Type
Errors\GetCountriesLibraryBadRequest	400	application/json
Errors\GetCountriesLibraryUnauthorized	401	application/json
Errors\SDKException	4XX, 5XX	*/*

getActorsLibrary

Retrieves a list of all the actors that are found for the media in this library.

Example Usage

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();



$response = $sdk->library->getActorsLibrary(
    sectionKey: 9518,
    type: Operations\GetActorsLibraryQueryParamType::TvShow

);

if ($response->object !== null) {
    // handle response
}

Parameters

Parameter	Type	Required	Description	Example
sectionKey	int	✔️	The unique key of the Plex library. Note: This is unique in the context of the Plex server.	9518
type	Operations\GetActorsLibraryQueryParamType	✔️	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	2

Response

?Operations\GetActorsLibraryResponse

Errors

Error Type	Status Code	Content Type
Errors\GetActorsLibraryBadRequest	400	application/json
Errors\GetActorsLibraryUnauthorized	401	application/json
Errors\SDKException	4XX, 5XX	*/*

getSearchAllLibraries

Search the provided query across all library sections, or a single section, and return matches as hubs, split up by type.

Example Usage

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\GetSearchAllLibrariesRequest(
    query: '<value>',
    clientID: '3381b62b-9ab7-4e37-827b-203e9809eb58',
    searchTypes: [
        Operations\SearchTypes::People,
    ],
    includeCollections: Operations\GetSearchAllLibrariesQueryParamIncludeCollections::Enable,
    includeExternalMedia: Operations\GetSearchAllLibrariesQueryParamIncludeExternalMedia::Enable,
);

$response = $sdk->library->getSearchAllLibraries(
    request: $request
);

if ($response->object !== null) {
    // handle response
}

Parameters

Parameter	Type	Required	Description
$request	Operations\GetSearchAllLibrariesRequest	✔️	The request object to use for the request.

Response

?Operations\GetSearchAllLibrariesResponse

Errors

Error Type	Status Code	Content Type
Errors\GetSearchAllLibrariesBadRequest	400	application/json
Errors\GetSearchAllLibrariesUnauthorized	401	application/json
Errors\SDKException	4XX, 5XX	*/*

getMediaMetaData

This endpoint will return all the (meta)data of one or more library items specified by the ratingKey. Multiple rating keys can be provided as a comma-separated list (e.g., "21119,21617").

Example Usage

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\GetMediaMetaDataRequest(
    ratingKey: '21119,21617',
    includeConcerts: true,
    includeExtras: true,
    includeOnDeck: true,
    includePopularLeaves: true,
    includePreferences: true,
    includeReviews: true,
    includeChapters: true,
    includeStations: true,
    includeExternalMedia: true,
    asyncAugmentMetadata: true,
    asyncCheckFiles: true,
    asyncRefreshAnalysis: true,
    asyncRefreshLocalMediaAgent: true,
);

$response = $sdk->library->getMediaMetaData(
    request: $request
);

if ($response->object !== null) {
    // handle response
}

Parameters

Parameter	Type	Required	Description
$request	Operations\GetMediaMetaDataRequest	✔️	The request object to use for the request.

Response

?Operations\GetMediaMetaDataResponse

Errors

Error Type	Status Code	Content Type
Errors\GetMediaMetaDataBadRequest	400	application/json
Errors\GetMediaMetaDataUnauthorized	401	application/json
Errors\SDKException	4XX, 5XX	*/*

getMediaArts

Returns the background artwork for a library item.

Example Usage

declare(strict_types=1);

require 'vendor/autoload.php';

use LukeHagar\Plex_API;

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



$response = $sdk->library->getMediaArts(
    ratingKey: 16099
);

if ($response->object !== null) {
    // handle response
}

Parameters

Parameter	Type	Required	Description	Example
ratingKey	int	✔️	the id of the library item to return the artwork of.	16099

Response

?Operations\GetMediaArtsResponse

Errors

Error Type	Status Code	Content Type
Errors\SDKException	4XX, 5XX	*/*

postMediaArts

Uploads an image to use as the background artwork for a library item, either from a local file or a remote URL

Example Usage

declare(strict_types=1);

require 'vendor/autoload.php';

use LukeHagar\Plex_API;

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



$response = $sdk->library->postMediaArts(
    ratingKey: 2268,
    url: 'https://api.mediux.pro/assets/fcfdc487-dd07-4993-a0c1-0a3015362e5b'

);

if ($response->statusCode === 200) {
    // handle response
}

Parameters

Parameter	Type	Required	Description	Example
ratingKey	int	✔️	the id of the library item to return the posters of.	2268
url	?string	➖	The URL of the image, if uploading a remote image	https://api.mediux.pro/assets/fcfdc487-dd07-4993-a0c1-0a3015362e5b
requestBody	?string	➖	The contents of the image, if uploading a local file

Response

?Operations\PostMediaArtsResponse

Errors

Error Type	Status Code	Content Type
Errors\SDKException	4XX, 5XX	*/*

getMediaPosters

Returns the available posters for a library item.

Example Usage

declare(strict_types=1);

require 'vendor/autoload.php';

use LukeHagar\Plex_API;

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



$response = $sdk->library->getMediaPosters(
    ratingKey: 16099
);

if ($response->object !== null) {
    // handle response
}

Parameters

Parameter	Type	Required	Description	Example
ratingKey	int	✔️	the id of the library item to return the posters of.	16099

Response

?Operations\GetMediaPostersResponse

Errors

Error Type	Status Code	Content Type
Errors\SDKException	4XX, 5XX	*/*

postMediaPoster

Uploads a poster to a library item, either from a local file or a remote URL

Example Usage

declare(strict_types=1);

require 'vendor/autoload.php';

use LukeHagar\Plex_API;

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



$response = $sdk->library->postMediaPoster(
    ratingKey: 2268,
    url: 'https://api.mediux.pro/assets/fcfdc487-dd07-4993-a0c1-0a3015362e5b'

);

if ($response->statusCode === 200) {
    // handle response
}

Parameters

Parameter	Type	Required	Description	Example
ratingKey	int	✔️	the id of the library item to return the posters of.	2268
url	?string	➖	The URL of the image, if uploading a remote image	https://api.mediux.pro/assets/fcfdc487-dd07-4993-a0c1-0a3015362e5b
requestBody	?string	➖	The contents of the image, if uploading a local file

Response

?Operations\PostMediaPosterResponse

Errors

Error Type	Status Code	Content Type
Errors\SDKException	4XX, 5XX	*/*

getMetadataChildren

This endpoint will return the children of of a library item specified with the ratingKey.

Example Usage

declare(strict_types=1);

require 'vendor/autoload.php';

use LukeHagar\Plex_API;

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



$response = $sdk->library->getMetadataChildren(
    ratingKey: 2403.67,
    includeElements: 'Stream'

);

if ($response->object !== null) {
    // handle response
}

Parameters

Parameter	Type	Required	Description
ratingKey	float	✔️	the id of the library item to return the children of.
includeElements	?string	➖	Adds additional elements to the response. Supported types are (Stream)

Response

?Operations\GetMetadataChildrenResponse

Errors

Error Type	Status Code	Content Type
Errors\GetMetadataChildrenBadRequest	400	application/json
Errors\GetMetadataChildrenUnauthorized	401	application/json
Errors\SDKException	4XX, 5XX	*/*

getTopWatchedContent

This endpoint will return the top watched content from libraries of a certain type

Example Usage

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();



$response = $sdk->library->getTopWatchedContent(
    type: Operations\GetTopWatchedContentQueryParamType::TvShow,
    includeGuids: Operations\GetTopWatchedContentQueryParamIncludeGuids::Enable

);

if ($response->object !== null) {
    // handle response
}

Parameters

Parameter	Type	Required	Description	Example
type	Operations\GetTopWatchedContentQueryParamType	✔️	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	2
includeGuids	?Operations\GetTopWatchedContentQueryParamIncludeGuids	➖	Adds the Guid object to the response	1

Response

?Operations\GetTopWatchedContentResponse

Errors

Error Type	Status Code	Content Type
Errors\GetTopWatchedContentBadRequest	400	application/json
Errors\GetTopWatchedContentUnauthorized	401	application/json
Errors\SDKException	4XX, 5XX	*/*