Skip to main content
GET
/
media
/
{mediaId}
TypeScript
import { DiscovrClient } from "discovr";
import type { MediaResponse } from "discovr";

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

// After sign-in and profile selection …
const response: MediaResponse = await discovr.getMedia("example");
console.log(response);
{
  "id": "<string>",
  "media_type": "movie",
  "movie": {
    "id": "<string>",
    "tmdb_id": 123,
    "title": "<string>",
    "original_title": "<string>",
    "overview": "<string>",
    "poster_path": "https://image.tmdb.org/t/p/original/kqjL17yufvn9OVLyXYpvtyrFfak.jpg",
    "backdrop_path": "https://image.tmdb.org/t/p/original/kqjL17yufvn9OVLyXYpvtyrFfak.jpg",
    "release_date": "2023-12-25",
    "runtime": 123,
    "vote_average": 123,
    "vote_count": 123,
    "popularity": 123,
    "genres": [
      {
        "tmdb_id": 123,
        "name": "<string>"
      }
    ],
    "tagline": "<string>",
    "status": "<string>",
    "budget": 123,
    "revenue": 123,
    "homepage": "<string>",
    "imdb_id": "<string>"
  },
  "tv": {
    "id": "<string>",
    "tmdb_id": 123,
    "name": "<string>",
    "original_name": "<string>",
    "overview": "<string>",
    "poster_path": "https://image.tmdb.org/t/p/original/kqjL17yufvn9OVLyXYpvtyrFfak.jpg",
    "backdrop_path": "https://image.tmdb.org/t/p/original/kqjL17yufvn9OVLyXYpvtyrFfak.jpg",
    "first_air_date": "2023-12-25",
    "last_air_date": "2023-12-25",
    "number_of_episodes": 123,
    "number_of_seasons": 123,
    "vote_average": 123,
    "vote_count": 123,
    "popularity": 123,
    "genres": [
      {
        "tmdb_id": 123,
        "name": "<string>"
      }
    ],
    "tagline": "<string>",
    "status": "<string>",
    "homepage": "<string>",
    "in_production": true,
    "seasons": [
      {
        "tmdb_id": 123,
        "name": "<string>",
        "episode_count": 123,
        "season_number": 123,
        "air_date": "2023-12-25",
        "poster_path": "https://image.tmdb.org/t/p/original/kqjL17yufvn9OVLyXYpvtyrFfak.jpg"
      }
    ]
  }
}

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).

Pattern: ^(MV|TV)_\d+$

Response

Full media details returned successfully.

Full details for a movie or TV show.

id
string
required

The unique identifier of the media item.

media_type
enum<string>
required

Whether this is a movie or TV show.

Available options:
movie,
tv
movie
MediaResponseMovie · object

Movie details — only present when media_type is movie.

tv
MediaResponseTv · object

TV show details — only present when media_type is tv.