Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.discovr.media/llms.txt

Use this file to discover all available pages before exploring further.

Retrieves all items from the playback list for a specific profile. Items are returned in descending order by updatedAt (newest first), then by createdAt. Supports cursor-based pagination using the nextPageToken query parameter. Pagination:
  • Use nextPageToken from the previous response to fetch the next page
  • If hasMore is true, there are more items available on subsequent pages.
Playback Progress: Each item in the playback list includes a progress field (0-100) indicating the playback progress percentage. Media Assets: All items include media assets (id, title, poster_path, backdrop_path) automatically. Episode-level items also include episode_image and episode_title.

​
Parameters

NameTypeRequiredDescription
nextPageTokenstringNoOpaque token from previous page for pagination
limitintegerNoMaximum number of items to return (1-50, default: 10)

​
Returns

PlaybackListResponse — List of playback items retrieved successfully 
{
  "items": [
{
  "id": "string",
  "mediaType": "movie" /* enum: "movie", "tv" */,
  "title": "string",
  "poster_path": "string",
  "backdrop_path": "string",
  "episode_image": "string",
  "episode_title": "string",
  "progress": 0.0,
  "updatedAt": "string" /* date-time */,
  "season": 0,
  "episode": 0,
  "createdAt": "string" /* date-time */
}
],
  "hasMore": false,
  "nextPageToken": "string"
}

​
Example

import { DiscovrClient } from "discovr";
import type { PlaybackListResponse } from "discovr";

const discovr = new DiscovrClient("your-client-id", {
  basePath: "https://api.discovr.media",
});

// After sign-in and profile selection …
const response: PlaybackListResponse = await discovr.getPlaybackItems({ nextPageToken: "example", limit: 10 });
console.log(response);