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.

Retrieves details for a specific TV season, including its episodes. The series ID must be prefixed with “TV_”. This endpoint wraps TMDB’s season details endpoint and transforms IDs and image paths. See TMDB TV Season Details Documentation for details.

​
Parameters

NameTypeRequiredDescription
mediaIdstringYesThe unique identifier of the TV show (e.g., “TV_1399”)
seasonNumberintegerYesThe season number
languagestringNoISO 639-1 language code to filter results by language.

​
Returns

SeasonDetailsResponse — Season details retrieved successfully 
{
  "show_id": "string",
  "show_tmdb_id": 0,
  "tmdb_internal_id": "string",
  "id": 0,
  "season_tmdb_id": 0,
  "name": "string",
  "overview": "string",
  "poster_path": "string",
  "season_number": 0,
  "air_date": "string" /* date */,
  "episodes": [
{
  "episode_tmdb_id": 0,
  "episode_number": 0,
  "name": "string",
  "overview": "string",
  "still_path": "string",
  "air_date": "string" /* date */,
  "runtime": 0,
  "season_number": 0,
  "show_id": 0,
  "production_code": "string",
  "vote_average": 0.0,
  "vote_count": 0,
  "crew": [
{ /* EpisodeCrewItem — object shape not expanded in OpenAPI */ }
],
  "guest_stars": [
{ /* EpisodeGuestStarItem — object shape not expanded in OpenAPI */ }
]
}
]
}

​
Example

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