Get TV episode
get_tv_episodeRetrieve details for a specific TV episode using show ID, season, and episode number, including overview, air date, runtime, guest stars, credits, and IMDb ID.
Instructions
Get one episode of a TV show by show id + season number + episode number: overview, air date, runtime, TMDB vote average (vote_average, TMDB's own 0-10 user score, not an IMDb/RT/Metacritic score; get_movie/get_tv's ratings are whole-show only and this tool makes no OMDb call), guest stars (up to 15) and director/writer. Also returns the episode's own imdb_id/imdb_url; pass that id to get_ratings for this episode's IMDb rating, the only way to get a per-episode IMDb score here. Get the show id from search_tv.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"id": "<id>",
"season_number": "<season_number>",
"episode_number": "<episode_number>"
},
"name": "get_tv_episode"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | TMDB TV show id (from search_tv). | |
| season_number | Yes | Season number (0 = specials). | |
| episode_number | Yes | Episode number within the season. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| crew | Yes | ||
| name | Yes | ||
| imdb_id | Yes | This episode's own IMDb id (not the show's) — pass it to get_ratings for the episode's IMDb rating, which no TMDB field carries. Null when TMDB has no IMDb id for it. | |
| air_date | Yes | ||
| imdb_url | Yes | ||
| overview | Yes | ||
| still_url | Yes | ||
| guest_stars | Yes | ||
| vote_average | Yes | TMDB's own 0-10 user score. A different audience and scale from the IMDb/RT/Metacritic scores get_movie/get_tv return as `ratings` — don't compare, average or substitute across the two. | |
| season_number | Yes | ||
| episode_number | Yes | ||
| runtime_minutes | Yes |