TVmaze

TV schedules and TV show details

TVmaze provides TV schedules, broadcast and streaming releases, and show status, ratings, and episode details; streaming times may be unavailable or shown in UTC.

Get show

Get a TV show’s status, schedule, episode information, rating and full episode list from its name or TVmaze show link. The full list includes specials when requested. Time zones and airing times may be unavailable for streaming shows.

Your information

Show

Show name or TVmaze show link, for example Severance or https://www.tvmaze.com/shows/44933/severance.

More options

Include EpisodesOptional

Include the full episode list, including specials; for example true.

1 credit per completed run

The same inputs also work from your code or an AI assistant. See For developers.

Example results

The Last of Us

running7.9

After a global pandemic destroys civilization, a hardened survivor takes charge of a 14-year-old girl who may be humanity's last hope.

First airedJan 15, 2023

Network or serviceHBO

Schedule

Days: Sunday
Time: 21:00
Time zone: America/New_York

Episode information

Previous episode: Convergence
Previously aired: May 26, 9:00 PM

Genres: Drama, Action, Horror
Country: United States

Official site View on TVmaze

Episodes

About the TVmaze tool

TVmaze’s Get tv schedule method returns broadcasts and optional streaming releases for a date and country.

TVmaze’s Get show method returns show details and optionally a full episode list, using a show name or TVmaze link.

Built from tvmaze.com. Last checked Sep 29, 2026.

Actions

Get show

1 credit

What you provide

Field	Type	Required	Description
Show`show`	Text	Required	Show name or TVmaze show link, for example Severance or https://www.tvmaze.com/shows/44933/severance.Example: The Last of Us
Include Episodes`include_episodes`	Yes or no	Optional	Include the full episode list, including specials; for example true.Example: No

What you get

Field	Type	Description
Name`name`	Text	Example: The Last of Us
Genres`genres`	List
Status`status`	Text	Example: Running
Country`country`	Text	Example: United States
Summary`summary`	Text	Example: After a global pandemic destroys civilization, a hardened survivor takes…
End Date`end_date`	Date	Example: 2022-12-18
Episodes`episodes`	List
Title`episodes[].title`	Text	Example: When You're Lost in the Darkness
Number`episodes[].number`	Number	Example: 1
Season`episodes[].season`	Number	Example: 1
Runtime`episodes[].runtime`	Text	Example: 85 minutes
Air Date`episodes[].air_date`	Date	Example: 2023-01-15
Tvmaze Link`episodes[].tvmaze_link`	Text	Example: https://www.tvmaze.com/episodes/2423934/the-last-of-us-1x01-when-youre-lost-in…
Schedule`schedule`	Details
Days`schedule.days`	List
Time`schedule.time`	Text	Example: 21:00
Time Zone`schedule.time_zone`	Text	Example: America/New_York
Tvmaze ID`tvmaze_id`	Number	Example: 46562
Image Link`image_link`	Text	Example: https://static.tvmaze.com/uploads/images/original_untouched/563/1409008.jpg
Tvmaze Link`tvmaze_link`	Text	Example: https://www.tvmaze.com/shows/46562/the-last-of-us
Next Episode`next_episode`	Value
Official Site`official_site`	Text	Example: https://www.hbo.com/the-last-of-us
Premiere Date`premiere_date`	Date	Example: 2023-01-15
Average Rating`average_rating`	Number	Average rating out of 10.Example: 7.9
Previous Episode`previous_episode`	Value
Network or Streaming Service`network_or_streaming_service`	Text	Example: HBO

Example result

For Show: The Last of Us

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"
}

Get tv schedule

1 credit

Get TV broadcasts and, optionally, new streaming episodes scheduled for a date in a country. Worldwide streaming releases are included when streaming is on; airtimes for releases without a local timezone are shown in UTC.

What you provide

Field	Type	Required	Description
Date`date`	Date	Optional	Schedule date, for example 2026-09-29. Defaults to today.Example: 2026-09-29
Country`country`	Text	Optional	Country name or two-letter code, such as United States or US.Example: United States
Max Results`max_results`	Number	Optional	Maximum number of episodes, for example 200.Example: 25
Include Streaming`include_streaming`	Yes or no	Optional	Include local and worldwide streaming releases, for example true.Example: No

What you get

Field	Type	Description
Episodes`episodes`	List	Episodes in air-time order.
Genres`episodes[].genres`	List	Show genres.
Runtime`episodes[].runtime`	Text	Episode runtime as text, such as 30 min.Example: 60 min
Show ID`episodes[].show_id`	Number	TVmaze show ID.Example: 10594
Show Name`episodes[].show_name`	Text	Show name.Example: Squawk Box Europe
Episode ID`episodes[].episode_id`	Number	TVmaze episode ID.Example: 3724393
Air Datetime`episodes[].air_datetime`	Text	Air date and time in ISO 8601 with an offset, in the service timezone when available.Example: 2026-09-29T04:00:00+01:00
Episode Link`episodes[].episode_link`	Text	TVmaze episode page.Example: https://www.tvmaze.com/episodes/3724393/squawk-box-europe-2026-09-28-episode-193
Episode Title`episodes[].episode_title`	Text	Episode title.Example: Episode 193
Season Number`episodes[].season_number`	Number	Season number.Example: 2026
Episode Number`episodes[].episode_number`	Number	Episode number.Example: 193
Runtime (minutes)`episodes[].runtime_minutes`	Number	Episode runtime in minutes.Example: 60
Network or Streaming Service`episodes[].network_or_streaming_service`	Text	Broadcast network or streaming service.Example: CNBC Europe

Example result

For Date: 2026-09-29, Country: United Kingdom, Max Results: 25, Include Streaming: No

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"
    }
  ]
}

For developers

Call it from your code with one request. Change the values in input to run it on new data. To get an API key, open Developers at the bottom of Studio, turn on Developer mode and go to API keys.

cURL

curl 'https://api.fous.com/v1/query' \
  --fail-with-body --silent --show-error --max-time 180 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "api": "@tvmaze",
  "visibility": "public",
  "operation": "get_show",
  "version": 1,
  "input": {
    "show": "The Last of Us"
  },
  "response": {
    "format": "json"
  }
}'

What you can do with it

Plan viewing around upcoming broadcasts and streaming releases
Track show schedules and episode details
Compare episode runtimes across shows
Organize shows by genre and status
Review show ratings and premiere dates

Questions about TVmaze

Can I run it with my own inputs?

Yes. Change the inputs in Studio and press Run, or send new inputs from your code, or ask a connected AI assistant.

Can I call this TVmaze tool as an API?

Yes. Send a POST request to /v1/query with your Fous API key and the inputs, and get JSON back.

How much does it cost?

Each completed run costs 1 credit. Failed runs without a completed receipt are free; completed work can remain charged if delivery is interrupted. With pay as you go, a credit costs 1¢. Monthly plans cost less per credit.

Do I need a TVmaze account?

No. You only need a Fous account.

How current is the data?

Fous gets the data from tvmaze.com when you run it. Some results are reused for up to 24 hours, and results that use your account or key are never reused. It was last verified on Sep 29, 2026.