Get TV show details
get_tvFetch complete TV show information using a TMDB ID: overview, genres, seasons, networks, creators, status, age rating, and ratings from IMDb, Rotten Tomatoes, and Metacritic, including awards.
Instructions
Get full details for one TV show by TMDB id: overview, genres, seasons/episodes counts, networks, created_by (the show's creator(s)), status, the age/content rating (certification) for region — falling back to the US rating, then any available country, when region has none; check certification_region to see which one was used — and links. By default also includes IMDb/Rotten Tomatoes/Metacritic ratings and an awards summary (see include_ratings), plus OMDb's own age rating (ratings.rated — separate from this tool's own certification above; the two can differ) from OMDb (set include_ratings=false to skip); if unavailable (no OMDB_API_KEY, no imdb_id, or the OMDb lookup fails), ratings degrades to {found:false, reason} instead of failing the call. Set expand_episodes=true to also pull every season's episode list in one extra request instead of calling get_tv_season per season. If you only need the headline info (name/year/genres/vote average, season/episode counts) — for one id or several — use get_tv_shows instead; it's trimmed on purpose and skips the rest of this payload. Get the id from search_tv.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | TMDB numeric id. | |
| region | No | ISO-3166-1 country code for region-specific results (default 'US'). | |
| language | No | Override the response language (ISO-639-1, optionally with a region), e.g. 'ru-RU' or 'en-US'. Localizes titles/overviews/genre names. Defaults to the server's TMDB_LANGUAGE. | |
| expand_episodes | No | If true, also fetch every season's full episode list (name, air date, runtime, rating) as `seasons_detail`, in one extra request — use this instead of calling get_tv_season once per season when you need all episodes of a multi-season show. Episode overviews are omitted here to keep that aggregate response usable — call get_tv_season for one season's full detail including overview. Each season's episode list is capped at 50 (season 0 'Specials' in particular can otherwise run to hundreds of bonus clips), and the combined count across every season is capped at 250 total, and the whole aggregate additionally has a hard size ceiling (trims further if episode names are unusually long) since a 30+ season show could otherwise still exceed a usable response size even with the per-season cap alone; `episode_count` on each season still reports that season's true total. The 250 budget is spent in season order starting at season 0, so on a long-running show the specials are served first and the last seasons are the ones that fall off. A season that falls entirely beyond the 250-episode budget is skipped rather than fetched-then-discarded, so its `overview`/`poster_url` come back null too, not just its `episodes` list — call get_tv_season for that season's full detail. Defaults to false. | |
| include_ratings | No | If true (default), enrich the result with IMDb/Rotten Tomatoes/Metacritic ratings plus an awards summary (major-award wins/nominations — Oscars, Emmys, Golden Globes, etc., whatever OMDb aggregates; free text, not a structured count, and describes the whole film/show, not any one person's award) from OMDb (requires OMDB_API_KEY). Set false to skip the extra lookup when ratings are not needed. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | ||
| name | No | ||
| type | Yes | ||
| genres | Yes | ||
| status | Yes | ||
| imdb_id | Yes | ||
| ratings | No | ||
| seasons | Yes | ||
| tagline | Yes | ||
| homepage | Yes | ||
| imdb_url | Yes | ||
| networks | Yes | ||
| overview | Yes | ||
| tmdb_url | Yes | ||
| created_by | Yes | ||
| media_type | Yes | ||
| popularity | Yes | ||
| poster_url | Yes | ||
| vote_count | Yes | ||
| vote_average | Yes | ||
| certification | Yes | ||
| in_production | Yes | ||
| last_air_date | Yes | ||
| original_name | No | ||
| certifications | Yes | ||
| first_air_date | Yes | ||
| seasons_detail | No | ||
| episode_run_time | Yes | ||
| number_of_seasons | Yes | ||
| original_language | Yes | ||
| number_of_episodes | Yes | ||
| last_episode_to_air | Yes | ||
| next_episode_to_air | Yes | ||
| certification_region | Yes |