GET
/
library
/
all
/
top
using LukeHagar.PlexAPI.SDK;
using LukeHagar.PlexAPI.SDK.Models.Components;
using LukeHagar.PlexAPI.SDK.Models.Requests;

var sdk = new PlexAPI(accessToken: "<YOUR_API_KEY_HERE>");

var res = await sdk.Library.GetTopWatchedContentAsync(
    type: GetTopWatchedContentQueryParamType.TvShow,
    includeGuids: 1
);

// handle response
{
  "MediaContainer": {
    "size": 1,
    "allowSync": true,
    "identifier": "com.plexapp.plugins.library",
    "mediaTagPrefix": "/system/bundle/media/flags/",
    "mediaTagVersion": 1698860922,
    "Metadata": [
      {
        "ratingKey": "17",
        "key": "/library/metadata/17",
        "guid": "plex://movie/5d77683f6f4521001ea9dc53",
        "slug": "waterloo-road",
        "studio": "Universal Pictures",
        "type": "movie",
        "title": "Serenity",
        "librarySectionTitle": "Movies",
        "librarySectionID": 1,
        "librarySectionKey": "/library/sections/1",
        "contentRating": "PG-13",
        "summary": "Serenity continues the story of the TV series it was based upon (\"Firefly\"). River Tam had a secret - one in which she's not even aware - so dangerous, no one's safe, as an Alliance operative's sent to capture her, and all others are considered irrelevant to his job.",
        "index": 1,
        "audienceRating": 9.1,
        "year": 2005,
        "tagline": "They aim to misbehave.",
        "thumb": "/library/metadata/17/thumb/1705637165",
        "art": "/library/metadata/17/art/1705637165",
        "duration": 141417,
        "originallyAvailableAt": "2005-09-29T00:00:00.000Z",
        "leafCount": 222,
        "viewedLeafCount": 100,
        "childCount": 13,
        "addedAt": 1705637164,
        "updatedAt": 1705637165,
        "globalViewCount": 80,
        "audienceRatingImage": "rottentomatoes://image.rating.upright",
        "Genre": [
          {
            "id": 184,
            "filter": "genre=184",
            "tag": "Thriller"
          }
        ],
        "Country": [
          {
            "id": 116,
            "filter": "country=116",
            "tag": "United States of America"
          }
        ],
        "Guid": [
          {
            "id": "tvdb://2337"
          }
        ],
        "Role": [
          {
            "id": 220,
            "filter": "actor=220",
            "tag": "Dennis Keiffer",
            "tagKey": "5d77683554f42c001f8c4708",
            "role": "Bar Guy (uncredited)",
            "thumb": "https://metadata-static.plex.tv/6/people/648e9a7ea1d537bccfcd7615134b78ce.jpg"
          }
        ],
        "User": [
          {
            "id": 220
          }
        ]
      }
    ]
  }
}

Authorizations

​
X-Plex-Token
string
header
required

Plex Authentication Token

Query Parameters

​
includeGuids
integer

Adds the Guids object to the response

​
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

Response

200
application/json
The metadata of the library item.
​
MediaContainer
object
Get Items ChildrenGet On Deck