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.

Checks if the media item exists in any of the profile’s lists. Returns boolean flags for each list type (watchlist, liked, disliked, super_liked, history) and playback information if the media is in the playback list. Note: The “completed” and “watched” fields have been removed. Use “history” to check if media has been watched. When providers=true, also returns streaming provider information for the media, showing which of the user’s selected providers have the media available and in which regions.

Parameters

NameTypeRequiredDescription
mediaIdstringYesThe unique identifier of the media item
providersbooleanNoIf true, include streaming provider information in the response

Returns

MediaProfileMeta — Profile metadata retrieved successfully
{
  "watchlist": false,
  "liked": false,
  "disliked": false,
  "super_liked": false,
  "playback": {
  "inlist": false,
  "data": {
  "mediaId": "string",
  "mediaType": "movie" /* enum: "movie", "tv" */,
  "createdAt": "string" /* date-time */,
  "progress": 0.0,
  "updatedAt": "string" /* date-time */,
  "season": 0,
  "episode": 0
}
},
  "history": false,
  "providers": [
{
  "id": "string",
  "title": "string",
  "logos": { },
  "regions": { }
}
]
}

Example

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

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

// After sign-in and profile selection …
const response: MediaProfileMeta = await discovr.getMediaProfileMeta("example", { providers: false });
console.log(response);