# 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. Unofficial. Not affiliated with or endorsed by TVmaze. - Page: https://fous.com/methods/tvmaze.com/get-tv-schedule - Method: `tvmaze.com/get_tv_schedule`, version 1 - Website: tvmaze.com - Returns: air time, show, season/episode, title, network or streaming service, runtime, genres, links and IDs - 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 | |---|---|---|---|---| | `date` | string | no | `"2026-09-29"` | Schedule date, for example 2026-09-29. Defaults to today. | | `country` | string | no | `"United Kingdom"` | Country name or two-letter code, such as United States or US. Default "United States". | | `max_results` | integer | no | `25` | Maximum number of episodes, for example 200. Default 200. | | `include_streaming` | boolean | no | `false` | Include local and worldwide streaming releases, for example true. Default true. | ## Output From a run on Oct 23, 2026, shortened. Its input: ```json { "date": "2026-09-29", "country": "United Kingdom", "max_results": 25, "include_streaming": false } ``` Its output: ```json { "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" } ] } ``` ## 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_tv_schedule","input":{"date":"2026-09-29","country":"United Kingdom","max_results":25,"include_streaming":false}}' ``` 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 - 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. ## Input schema ```json { "type": "object", "properties": { "date": { "type": "string", "examples": [ "2026-09-29" ], "description": "Schedule date, for example 2026-09-29. Defaults to today." }, "country": { "type": "string", "default": "United States", "examples": [ "United States" ], "description": "Country name or two-letter code, such as United States or US." }, "max_results": { "type": "integer", "default": 200, "maximum": 500, "minimum": 1, "description": "Maximum number of episodes, for example 200." }, "include_streaming": { "type": "boolean", "default": true, "description": "Include local and worldwide streaming releases, for example true." } } } ``` ## Output schema ```json { "type": "object", "required": [ "episodes" ], "properties": { "episodes": { "type": "array", "items": { "type": "object", "properties": { "genres": { "type": "array", "items": { "type": "string" } }, "runtime": { "type": [ "string", "null" ] }, "show_id": { "type": [ "integer", "null" ] }, "show_name": { "type": [ "string", "null" ] }, "episode_id": { "type": [ "integer", "null" ] }, "air_datetime": { "type": [ "string", "null" ] }, "episode_link": { "type": [ "string", "null" ] }, "episode_title": { "type": [ "string", "null" ] }, "season_number": { "type": [ "integer", "null" ] }, "episode_number": { "type": [ "integer", "null" ] }, "runtime_minutes": { "type": [ "integer", "null" ] }, "network_or_streaming_service": { "type": [ "string", "null" ] } } } } } } ``` ## See more - [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. - [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. - [AniList API: Get airing schedule](https://fous.com/methods/anilist.co/get-airing-schedule.md): Lists upcoming AniList anime episodes ordered by air time, with air times in the chosen time zone and available streaming links. - [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. - [MLB API: Get scores and schedule](https://fous.com/methods/mlb.com/get-scores.md): 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. - [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. - [Fandango API: Get movie showtimes](https://fous.com/methods/fandango.com/get-movie-showtimes.md): Finds a movie's showtimes at nearby US theaters on Fandango, with formats, local times and ticket links. - [JustWatch API: List new arrivals](https://fous.com/methods/justwatch.com/list-new-arrivals.md): Lists recently added movies and show seasons on streaming services in a country, newest first, from JustWatch listings. - [All TVmaze methods](https://fous.com/methods/tvmaze.com.md)