# TVmaze API: Get TV show details

> 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.

Unofficial. Not affiliated with or endorsed by TVmaze.

- Page: https://fous.com/methods/tvmaze.com/get-show
- Method: `tvmaze.com/get_show`, version 1
- Website: tvmaze.com
- Returns: name, status, premiere and end dates, network or streaming service, schedule, next and previous episode, rating, genres, summary, links, episodes
- 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 | `"The Last of Us"` | Show name or TVmaze show link, for example Severance or https://www.tvmaze.com/shows/44933/severance. |
| `include_episodes` | boolean | no |  | Include the full episode list, including specials; for example true. Default true. |

## Output

From a run on Oct 23, 2026, shortened. Its input:

```json
{
  "show": "The Last of Us"
}
```

Its output:

```json
{
  "name": "The Last of Us",
  "genres": [
    "Drama",
    "Action",
    "Horror"
  ],
  "status": "running",
  "country": "United States",
  "summary": "After a global pandemic destroys civilization, a hardened survivor takes charge of a 14-year-old girl who may be humanity's last hope.",
  "end_date": null,
  "episodes": [
    {
      "title": "When You're Lost in the Darkness",
      "number": 1,
      "season": 1,
      "runtime": "85 minutes",
      "air_date": "2023-01-15",
      "tvmaze_link": "https://www.tvmaze.com/episodes/2423934/the-last-of-us-1x01-when-youre-lost-in-the-darkness"
    },
    {
      "title": "Infected",
      "number": 2,
      "season": 1,
      "runtime": "56 minutes",
      "air_date": "2023-01-22",
      "tvmaze_link": "https://www.tvmaze.com/episodes/2446254/the-last-of-us-1x02-infected"
    },
    {
      "title": "Long, Long Time",
      "number": 3,
      "season": 1,
      "runtime": "81 minutes",
      "air_date": "2023-01-29",
      "tvmaze_link": "https://www.tvmaze.com/episodes/2446255/the-last-of-us-1x03-long-long-time"
    }
  ],
  "schedule": {
    "days": [
      "Sunday"
    ],
    "time": "21:00",
    "time_zone": "America/New_York"
  },
  "tvmaze_id": 46562,
  "image_link": "https://static.tvmaze.com/uploads/images/original_untouched/563/1409008.jpg",
  "tvmaze_link": "https://www.tvmaze.com/shows/46562/the-last-of-us",
  "next_episode": null,
  "official_site": "https://www.hbo.com/the-last-of-us",
  "premiere_date": "2023-01-15",
  "average_rating": 7.9,
  "previous_episode": {
    "title": "Convergence",
    "number": 7,
    "season": 2,
    "tvmaze_link": "https://www.tvmaze.com/episodes/3153912/the-last-of-us-2x07-convergence",
    "air_date_time": "2025-05-25T21:00:00-04:00"
  },
  "network_or_streaming_service": "HBO"
}
```

## 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":"tvmaze.com/get_show","input":{"show":"The Last of Us"}}'
```

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

- Is The Bear still airing or has it ended, and when does the next episode come out?
- What network carries Shogun and what's its average rating?
- Give me the full episode list for Slow Horses, specials included.
- Show me the premiere date, genres, and schedule for the Last of Us on tvmaze.com.
- Look up Severance at https://www.tvmaze.com/shows/44933/severance and tell me the previous episode and the summary.

## Input schema

```json
{
  "type": "object",
  "required": [
    "show"
  ],
  "properties": {
    "show": {
      "type": "string",
      "description": "Show name or TVmaze show link, for example Severance or https://www.tvmaze.com/shows/44933/severance."
    },
    "include_episodes": {
      "type": "boolean",
      "default": true,
      "description": "Include the full episode list, including specials; for example true."
    }
  },
  "additionalProperties": false
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "name",
    "status",
    "premiere_date",
    "end_date",
    "network_or_streaming_service",
    "country",
    "schedule",
    "next_episode",
    "previous_episode",
    "average_rating",
    "genres",
    "summary",
    "official_site",
    "image_link",
    "tvmaze_link",
    "episodes",
    "tvmaze_id"
  ],
  "properties": {
    "name": {
      "type": "string"
    },
    "genres": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "status": {
      "type": "string"
    },
    "country": {
      "type": [
        "string",
        "null"
      ]
    },
    "summary": {
      "type": [
        "string",
        "null"
      ]
    },
    "end_date": {
      "type": [
        "string",
        "null"
      ],
      "format": "date"
    },
    "episodes": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "season",
          "number",
          "title",
          "air_date",
          "runtime",
          "tvmaze_link"
        ],
        "properties": {
          "title": {
            "type": [
              "string",
              "null"
            ]
          },
          "number": {
            "type": [
              "integer",
              "null"
            ]
          },
          "season": {
            "type": [
              "integer",
              "null"
            ]
          },
          "runtime": {
            "type": [
              "string",
              "null"
            ]
          },
          "air_date": {
            "type": [
              "string",
              "null"
            ],
            "format": "date"
          },
          "tvmaze_link": {
            "type": [
              "string",
              "null"
            ]
          }
        },
        "additionalProperties": false
      }
    },
    "schedule": {
      "type": "object",
      "required": [
        "days",
        "time",
        "time_zone"
      ],
      "properties": {
        "days": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "time": {
          "type": [
            "string",
            "null"
          ]
        },
        "time_zone": {
          "type": [
            "string",
            "null"
          ]
        }
      },
      "additionalProperties": false
    },
    "tvmaze_id": {
      "type": "integer",
      "x-fous-developer": true
    },
    "image_link": {
      "type": [
        "string",
        "null"
      ]
    },
    "tvmaze_link": {
      "type": "string"
    },
    "next_episode": {
      "anyOf": [
        {
          "type": "object",
          "required": [
            "season",
            "number",
            "title",
            "air_date_time",
            "tvmaze_link"
          ],
          "properties": {
            "title": {
              "type": [
                "string",
                "null"
              ]
            },
            "number": {
              "type": [
                "integer",
                "null"
              ]
            },
            "season": {
              "type": [
                "integer",
                "null"
              ]
            },
            "tvmaze_link": {
              "type": [
                "string",
                "null"
              ]
            },
            "air_date_time": {
              "type": [
                "string",
                "null"
              ]
            }
          },
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "official_site": {
      "type": [
        "string",
        "null"
      ]
    },
    "premiere_date": {
      "type": [
        "string",
        "null"
      ],
      "format": "date"
    },
    "average_rating": {
      "type": [
        "number",
        "null"
      ],
      "description": "Average rating out of 10."
    },
    "previous_episode": {
      "anyOf": [
        {
          "type": "object",
          "required": [
            "season",
            "number",
            "title",
            "air_date_time",
            "tvmaze_link"
          ],
          "properties": {
            "title": {
              "type": [
                "string",
                "null"
              ]
            },
            "number": {
              "type": [
                "integer",
                "null"
              ]
            },
            "season": {
              "type": [
                "integer",
                "null"
              ]
            },
            "tvmaze_link": {
              "type": [
                "string",
                "null"
              ]
            },
            "air_date_time": {
              "type": [
                "string",
                "null"
              ]
            }
          },
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "network_or_streaming_service": {
      "type": [
        "string",
        "null"
      ]
    }
  },
  "additionalProperties": false
}
```

## See more

- [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.
- [themoviedb.org API: Get TV show details](https://fous.com/methods/themoviedb.org/get-tv-show.md): 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.
- [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).
- [Crunchyroll API: Get series](https://fous.com/methods/crunchyroll.com/get-series.md): Gets public Crunchyroll series details by series name or series link; matches a series title rather than a movie.
- [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.
- [WEBTOON API: Get series](https://fous.com/methods/webtoons.com/get-series.md): Finds a WEBTOON series by name and returns its public details and newest publicly listed episodes. App-only episodes are excluded, and the public site shows no numeric rating.
- [MyAnimeList API: Look up an anime](https://fous.com/methods/myanimelist.net/get-anime.md): Looks up an anime on MyAnimeList by English or Japanese name, or by a MyAnimeList anime link. For ambiguous names it returns the most popular match.
- [All TVmaze methods](https://fous.com/methods/tvmaze.com.md)
