Skip to content

TVmaze API: Get TV schedule

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.

tvmaze.com (opens in a new tab)Version 1ReadNo sign-inVerified Nov 2, 2026

Unofficial. Not affiliated with or endorsed by TVmaze.

Inputs

Values from the run on Oct 23, 2026, shown under Output.

Date optionaldate

Schedule date, for example 2026-09-29. Defaults to today.

2026-09-29

Country optionalcountry

Country name or two-letter code, such as United States or US.

United Kingdom

Default United States.

Max Results optionalmax_results

Maximum number of episodes, for example 200.

25

Whole number from 1 to 500. Default 200.

Include Streaming optionalinclude_streaming

Include local and worldwide streaming releases, for example true.

false

True or false. Default true.

Output

From a run on Oct 23, 2026, shortened for this page.
{  "episodes": [    {      "genres": [],      "runtime": "60 min",      "show_id": 10594,      "show_name": "Squawk Box Europe",      "episode_id": 3724393,      "air_datetime": "2026-09-29T04:00:00+01:00",      "episode_link": "https://www.tvmaze.com/episodes/3724393/squawk-box-europe-2026-09-28-episode-193",      "episode_title": "Episode 193",      "season_number": 2026,      "episode_number": 193,      "runtime_minutes": 60,      "network_or_streaming_service": "CNBC Europe"    },    {      "genres": [],      "runtime": "75 min",      "show_id": 51281,      "show_name": "Morning Live",      "episode_id": 3769232,      "air_datetime": "2026-09-29T09:30:00+01:00",      "episode_link": "https://www.tvmaze.com/episodes/3769232/morning-live-8x85-episode-85",      "episode_title": "Episode 85",      "season_number": 8,      "episode_number": 85,      "runtime_minutes": 75,      "network_or_streaming_service": "BBC One"    },    {      "genres": [],      "runtime": "60 min",      "show_id": 8611,      "show_name": "Loose Women",      "episode_id": 3774921,      "air_datetime": "2026-09-29T12:30:00+01:00",      "episode_link": "https://www.tvmaze.com/episodes/3774921/loose-women-30x112-episode-112",      "episode_title": "Episode 112",      "season_number": 30,      "episode_number": 112,      "runtime_minutes": 60,      "network_or_streaming_service": "ITV1"    }  ]}
Price
1 credit per completed run (1¢ with pay as you go); failed runs are free.
Method
tvmaze.com/get_tv_schedule
Returns
air time, show, season/episode, title, network or streaming service, runtime, genres, links and IDs

Use it from your agent

Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method tvmaze.com/get_tv_schedule with the inputs above.

Ask your agent

  • What TV episodes are airing in the United States on 2026-09-29?
  • Show me tonight's broadcast schedule for the UK, limited to 50 episodes.
  • Which streaming releases come out in Canada on 2026-10-03, excluding regular broadcasts?
  • On TVmaze, what shows air on 2026-09-30 in Germany with their network and runtime?
  • I need the first 100 episodes scheduled for the US next Friday, including streaming drops, with season and episode numbers.
  • 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.com/get_show
  • 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.

    themoviedb.org/get_tv_show
  • Lists upcoming AniList anime episodes ordered by air time, with air times in the chosen time zone and available streaming links.

    anilist.co/get_airing_schedule
  • 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/list_upcoming_movies
  • Lists MLB games and scores for a date or up to seven days, optionally for one team. Start times are shown in the requested time zone.

    mlb.com/get_scores
  • 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/get_movie
  • Finds a movie's showtimes at nearby US theaters on Fandango, with formats, local times and ticket links.

    fandango.com/get_movie_showtimes
  • Lists recently added movies and show seasons on streaming services in a country, newest first, from JustWatch listings.

    justwatch.com/list_new_arrivals