Skip to main content
GET
/
media
/
{mediaId}
/
seasons
/
{seasonNumber}
Get TV season details
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.discovr.media/media/{mediaId}/seasons/{seasonNumber}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
{
  "show_id": "TV_1399",
  "show_tmdb_id": 1399,
  "id": 3572,
  "season_number": 1,
  "episodes": [
    {
      "episode_tmdb_id": 63056,
      "episode_number": 1,
      "name": "Winter Is Coming",
      "season_number": 1,
      "show_id": 1399,
      "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_1399")

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

The season number

Example:

1

Query Parameters

​
language
string

ISO 639-1 language code to filter results by language.

Example:

"en"

Response

Season details retrieved successfully

Detailed information about a TV season, including its episodes.

​
show_id
string
required

Our format: TV_{tmdbShowId}

Example:

"TV_1399"

​
show_tmdb_id
integer
required

Raw TMDB show ID

Example:

1399

​
id
integer
required

Season ID (same as _id in raw TMDB response)

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 TMDB ID (poster image ID)

Example:

"57599026c3a368369a000494"

​
season_tmdb_id
integer

Alias for id for clarity (TMDB season poster 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"