Skip to main content
GET
/
media
/
{mediaId}
/
profile_meta
TypeScript
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);
{
  "watchlist": true,
  "liked": true,
  "disliked": true,
  "super_liked": true,
  "playback": {
    "inlist": true,
    "data": {
      "mediaId": "<string>",
      "mediaType": "movie",
      "createdAt": "2023-11-07T05:31:56Z",
      "progress": 50,
      "updatedAt": "2023-11-07T05:31:56Z",
      "season": 2,
      "episode": 5
    }
  },
  "history": true,
  "providers": [
    {
      "id": "119",
      "title": "Amazon Prime Video",
      "logos": {
        "60": "https://is1-ssl.mzstatic.com/image/thumb/.../60x60bb.jpg",
        "100": "https://is1-ssl.mzstatic.com/image/thumb/.../100x100bb.jpg",
        "512": "https://is1-ssl.mzstatic.com/image/thumb/.../512x512bb.jpg",
        "1024": "https://is1-ssl.mzstatic.com/image/thumb/.../1024x1024bb.png"
      },
      "regions": {}
    }
  ]
}

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.

Authorizations

​
Authorization
string
header
required

Bearer token authentication.

  • Identity-tier endpoints (/profiles, /auth/session-token, /auth/session) accept a long-lived refresh token (rt_<hex>).
  • Session-tier endpoints (/pages/*, /profile/*) accept a short-lived session JWT.

SDK clients use two typed API accessors (identityApi() with the refresh token vs sessionApi() with the session JWT) — see the SDK DiscovrAuth helper.

Format: Authorization: Bearer {token}

Path Parameters

​
mediaId
string
required

The unique identifier of the media item. Use MV_<id> for movies or TV_<id> for TV shows (e.g., MV_550, TV_1396).

Query Parameters

​
providers
boolean
default:false

Set to true to include streaming provider availability in the response.

Response

Profile interaction data returned successfully.

The current profile's interaction data for a title.

​
watchlist
boolean
required
​
liked
boolean
required
​
disliked
boolean
required
​
super_liked
boolean
required
​
playback
MediaProfileMetaPlayback · object
required
​
history
boolean
required
​
providers
object[]

Streaming services where this title is available, filtered to the profile's selected providers. Only included when providers=true is passed.