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

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

// After sign-in and profile selection …
const response: SeasonDetailsResponse = await discovr.getSeasonDetails("example", 1, { language: "en" });
console.log(response);
{
  "show_id": "TV_1396",
  "show_tmdb_id": 1396,
  "id": 3572,
  "season_number": 1,
  "episodes": [
    {
      "episode_tmdb_id": 63056,
      "episode_number": 1,
      "name": "Winter Is Coming",
      "season_number": 1,
      "show_id": 1396,
      "overview": "<string>",
      "still_path": "https://image.tmdb.org/t/p/original/kqjL17yufvn9OVLyXYpvtyrFfak.jpg",
      "air_date": "2011-04-17",
      "runtime": 62,
      "production_code": "<string>",
      "vote_average": 9.1,
      "vote_count": 123,
      "crew": [
        {}
      ],
      "guest_stars": [
        {}
      ]
    }
  ],
  "tmdb_internal_id": "57599026c3a368369a000494",
  "season_tmdb_id": 3572,
  "name": "Season 1",
  "overview": "<string>",
  "poster_path": "https://image.tmdb.org/t/p/original/kqjL17yufvn9OVLyXYpvtyrFfak.jpg",
  "air_date": "2011-04-17"
}

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 TV show (e.g., TV_1396).

Pattern: ^(TV)_\d+$
​
seasonNumber
integer
required

The season number.

Example:

1

Query Parameters

​
language
string

ISO 639-1 language code for localised results (e.g., en).

Example:

"en"

Response

Season details returned successfully.

Detailed information about a TV season, including its episodes.

​
show_id
string
required

The TV show identifier (e.g., TV_1396).

Example:

"TV_1396"

​
show_tmdb_id
integer
required

Numeric identifier for the TV show.

Example:

1396

​
id
integer
required

Season identifier.

Example:

3572

​
season_number
integer
required

The number of the season

Example:

1

​
episodes
object[]
required

List of episodes in the season

​
tmdb_internal_id
string | null

Internal image asset identifier for the season.

Example:

"57599026c3a368369a000494"

​
season_tmdb_id
integer

Alias for id.

Example:

3572

​
name
string

Name of the season

Example:

"Season 1"

​
overview
string | null

Overview of the season

​
poster_path
string | null

Full URL to the season poster image (original size)

Example:

"https://image.tmdb.org/t/p/original/kqjL17yufvn9OVLyXYpvtyrFfak.jpg"

​
air_date
string<date> | null

Air date of the season

Example:

"2011-04-17"