# themoviedb.org API: Get TV show details > Finds a TV show on TMDB by exact name or TMDB show link and returns its details, cast, seasons, the last aired and next scheduled episodes, and the streaming services listed for a chosen country. Unofficial. Not affiliated with or endorsed by themoviedb.org. - Page: https://fous.com/methods/themoviedb.org/get-tv-show - Method: `themoviedb.org/get_tv_show`, version 1 - Website: themoviedb.org - Returns: name, overview, first and last air dates, status, next and last episodes, season and episode counts, seasons, networks, creators, cast, genres, user score, where to watch, poster, TMDB link and ID - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `show` | string | yes | `"https://www.themoviedb.org/tv/456-the-simpsons"` | Show name or TMDB show link, for example The Bear or https://www.themoviedb.org/tv/136315-the-bear. | | `country` | string | no | `"Canada"` | Country name or two-letter code for viewing services, for example Canada or CA. Defaults to United States. Default "United States". | ## Output From a run on Oct 31, 2026, shortened. Its input: ```json { "show": "https://www.themoviedb.org/tv/456-the-simpsons", "country": "Canada" } ``` Its output: ```json { "cast": [ { "name": "Dan Castellaneta", "character": "Homer Simpson / Abe Simpson / Barney Gumble / Krusty the Clown / Groundskeeper Willie / Mayor Quimby (voice)" }, { "name": "Julie Kavner", "character": "Marge Simpson / Patty Bouvier / Selma Bouvier / Jacqueline Bouvier (voice)" }, { "name": "Nancy Cartwright", "character": "Bart Simpson / Maggie Simpson / Nelson Muntz / Ralph Wiggum (voice)" } ], "name": "The Simpsons", "genres": [ "Animation", "Comedy" ], "status": "returning series", "seasons": [ { "name": "Specials", "number": 0, "air_date": "1987-04-15", "episode_count": 82 }, { "name": "Season 1", "number": 1, "air_date": "1989-12-17", "episode_count": 13 }, { "name": "Season 2", "number": 2, "air_date": "1990-10-11", "episode_count": 22 } ], "tmdb_id": 456, "creators": [ "Matt Groening" ], "networks": [ "FOX" ], "overview": "Set in Springfield, the average American town, the show focuses on the antics and everyday adventures of the Simpson family; Homer, Marge, Bart, Lisa and Maggie, as well as a virtual cast of thousands. Since the beginning, the series has been a pop culture icon, attracting hundreds of celebrities to…", "tmdb_link": "https://www.themoviedb.org/tv/456-the-simpsons", "poster_link": "https://image.tmdb.org/t/p/w500/uWpG7GqfKGQqX4YMAo3nv5OrglV.jpg", "next_episode": { "title": "Diary of a Chimpy Kid", "season": 38, "air_date": "2026-10-04", "episode_number": 2 }, "last_air_date": "2026-09-27", "first_air_date": "1989-12-17", "where_to_watch": [ "Disney Plus", "Crave", "Apple TV Store" ], "number_of_seasons": 38, "last_episode_aired": { "title": "The Children's Book Job", "season": 38, "air_date": "2026-09-27", "episode_number": 1 }, "number_of_episodes": 806, "user_score_percent": 80 } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"themoviedb.org/get_tv_show","input":{"show":"https://www.themoviedb.org/tv/456-the-simpsons","country":"Canada"}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## Ask your agent - When does the next episode of Severance air, and how many seasons are out so far? - Where can I stream Slow Horses in the UK? Also give me the cast and the show's user rating. - Pull up the TMDB page details for https://www.themoviedb.org/tv/1399-game-of-thrones: creators, networks, and the episode count per season. - Is Abbott Elementary still running or has it ended? Tell me the last episode that aired and which services carry it in Canada. - Look up Shōgun on TMDB and tell me its genres, first air date, and which streaming platforms have it in Australia. ## Input schema ```json { "type": "object", "required": [ "show" ], "properties": { "show": { "type": "string", "description": "Show name or TMDB show link, for example The Bear or https://www.themoviedb.org/tv/136315-the-bear." }, "country": { "type": "string", "default": "United States", "description": "Country name or two-letter code for viewing services, for example Canada or CA. Defaults to United States." } } } ``` ## Output schema ```json { "type": "object", "required": [ "name", "overview", "first_air_date", "last_air_date", "status", "next_episode", "last_episode_aired", "number_of_seasons", "number_of_episodes", "seasons", "networks", "creators", "cast", "genres", "user_score_percent", "where_to_watch", "poster_link", "tmdb_link", "tmdb_id" ], "properties": { "cast": { "type": "array", "items": { "type": "object", "required": [ "name", "character" ], "properties": { "name": { "type": "string", "description": "Actor name." }, "character": { "type": [ "string", "null" ], "description": "Character name." } }, "additionalProperties": false }, "description": "Up to 15 top-billed cast members." }, "name": { "type": "string", "description": "Show name." }, "genres": { "type": "array", "items": { "type": "string" }, "description": "Genres." }, "status": { "type": [ "string", "null" ], "description": "Returning series, ended, or canceled." }, "seasons": { "type": "array", "items": { "type": "object", "required": [ "number", "name", "episode_count", "air_date" ], "properties": { "name": { "type": "string", "description": "Season name." }, "number": { "type": "integer", "description": "Season number." }, "air_date": { "type": [ "string", "null" ], "description": "Premiere date, YYYY-MM-DD, if listed." }, "episode_count": { "type": "integer", "description": "Episode count." } }, "additionalProperties": false }, "description": "Seasons, including specials when listed." }, "tmdb_id": { "type": "integer", "description": "TMDB show ID.", "x-fous-developer": true }, "creators": { "type": "array", "items": { "type": "string" }, "description": "Show creators." }, "networks": { "type": "array", "items": { "type": "string" }, "description": "Broadcast networks." }, "overview": { "type": [ "string", "null" ], "description": "Show summary." }, "tmdb_link": { "type": "string", "description": "Show page link on TMDB." }, "poster_link": { "type": [ "string", "null" ], "description": "Show poster image link." }, "next_episode": { "anyOf": [ { "type": "object", "required": [ "air_date", "season", "episode_number", "title" ], "properties": { "title": { "type": "string", "description": "Episode title." }, "season": { "type": "integer", "description": "Season number." }, "air_date": { "type": [ "string", "null" ], "description": "Episode air date, YYYY-MM-DD." }, "episode_number": { "type": "integer", "description": "Episode number." } }, "additionalProperties": false }, { "type": "null" } ], "description": "Next scheduled episode, if listed." }, "last_air_date": { "type": [ "string", "null" ], "description": "Last recorded air date, YYYY-MM-DD." }, "first_air_date": { "type": [ "string", "null" ], "description": "Date the series first aired, YYYY-MM-DD." }, "where_to_watch": { "type": "array", "items": { "type": "string" }, "description": "Services listed for the chosen country." }, "number_of_seasons": { "type": "integer", "description": "Number of regular seasons." }, "last_episode_aired": { "anyOf": [ { "type": "object", "required": [ "air_date", "season", "episode_number", "title" ], "properties": { "title": { "type": "string", "description": "Episode title." }, "season": { "type": "integer", "description": "Season number." }, "air_date": { "type": [ "string", "null" ], "description": "Episode air date, YYYY-MM-DD." }, "episode_number": { "type": "integer", "description": "Episode number." } }, "additionalProperties": false }, { "type": "null" } ], "description": "Most recently aired episode, if listed." }, "number_of_episodes": { "type": "integer", "description": "Number of episodes." }, "user_score_percent": { "type": [ "integer", "null" ], "description": "TMDB user score as a percentage." } }, "additionalProperties": false } ``` ## See more - [themoviedb.org API: Get movie details](https://fous.com/methods/themoviedb.org/get-movie.md): Finds a movie on TMDB by exact title (optionally its release year) or by TMDB movie link, and returns its details, cast, crew, trailers, and the release date, age rating and streaming services for a chosen country. - [themoviedb.org API: List upcoming theatrical movies in a country](https://fous.com/methods/themoviedb.org/list-upcoming-movies.md): Lists movies scheduled for theatrical release in a country over the coming three weeks, soonest first, from TMDB's country-specific release calendar, with genres, overview and user score. - [themoviedb.org API: List trending movies and TV shows](https://fous.com/methods/themoviedb.org/list-trending.md): Lists TMDB homepage trending titles for today or this week in displayed order, with year, user score, overview and poster. The homepage shows up to 20 mixed movie and TV titles per period; the movie and TV filters select from those. - [TVmaze API: Get TV show details](https://fous.com/methods/tvmaze.com/get-show.md): Looks up a TV show by name or TVmaze link and returns its status, schedule, rating, next and previous episodes, and optionally the full episode list including specials. - [TVmaze API: Get TV schedule](https://fous.com/methods/tvmaze.com/get-tv-schedule.md): Gets the TV broadcasts scheduled in a country for a date from TVmaze. It can also add local and worldwide streaming releases. Airtimes are shown in the service's timezone, or in UTC when the service has none. - [IMDb API: Get movie or show](https://fous.com/methods/imdb.com/get-movie-or-show.md): Gets a movie or TV show's IMDb details from its name, IMDb title link or title ID; a year picks between titles with the same name. Unavailable details are null. - [Netflix API: Get movie or show](https://fous.com/methods/netflix.com/get-movie-or-show.md): Gets one Netflix movie or series by its exact name or Netflix title URL: title details, publicly shown seasons and episodes, and whether it is available in a given country's catalogue (checked against public JustWatch listings). - [Apple API: Get podcast](https://fous.com/methods/podcasts.apple.com/get-podcast.md): Gets an Apple Podcasts show's details and its newest available episodes, by show name or Apple Podcasts link. - [All themoviedb.org methods](https://fous.com/methods/themoviedb.org.md)