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 run

Example results

Name

The Last of Us

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

Not provided

Tvmaze ID

46562

Image Link

Open image

Tvmaze Link

tvmaze.com

Next Episode

Not provided

Official Site

hbo.com

Premiere Date

2023-01-15

Average Rating

7.9

Network or Streaming Service

HBO

Genres

Drama
Action
Horror

Episodes

Episodes
Title	Number	Season	Runtime	Air Date	Tvmaze Link
When You're Lost in the Darkness	1	1	85 minutes	2023-01-15	tvmaze.com
Infected	2	1	56 minutes	2023-01-22	tvmaze.com
Long, Long Time	3	1	81 minutes	2023-01-29	tvmaze.com
Please Hold to My Hand	4	1	50 minutes	2023-02-05	tvmaze.com
Endure and Survive	5	1	61 minutes	2023-02-12	tvmaze.com
Kin	6	1	62 minutes	2023-02-19	tvmaze.com
Left Behind	7	1	60 minutes	2023-02-26	tvmaze.com
When We Are in Need	8	1	60 minutes	2023-03-05	tvmaze.com
Look for the Light	9	1	46 minutes	2023-03-12	tvmaze.com
Making of The Last of Us	—	1	31 minutes	2023-03-12	tvmaze.com
Future Days	1	2	62 minutes	2025-04-13	tvmaze.com
Through the Valley	2	2	60 minutes	2025-04-20	tvmaze.com
The Path	3	2	60 minutes	2025-04-27	tvmaze.com
Day One	4	2	60 minutes	2025-05-04	tvmaze.com
Feel Her Love	5	2	50 minutes	2025-05-11	tvmaze.com
The Price	6	2	60 minutes	2025-05-18	tvmaze.com
Convergence	7	2	55 minutes	2025-05-25	tvmaze.com

Schedule

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

Previous Episode

Title: Convergence
Number: 7
Season: 2
Tvmaze Link: tvmaze.com
Air Date Time: 2025-05-25T21:00:00-04:00

Example data · Run in Studio for fresh results.

About TVmaze

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 by Fous from tvmaze.com and checked automatically; it last passed a check on Sep 29, 2026. Fous is not affiliated with TVmaze.

Actions

Get show

1 credit per run

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 per run

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.
Show ID`episodes[].show_id`	Number	TVmaze show ID.
Show Name`episodes[].show_name`	Text	Show name.
Episode ID`episodes[].episode_id`	Number	TVmaze episode ID.
Air Datetime`episodes[].air_datetime`	Text	Air date and time in ISO 8601 with an offset, in the service timezone when available.
Episode Link`episodes[].episode_link`	Text	TVmaze episode page.
Episode Title`episodes[].episode_title`	Text	Episode title.
Season Number`episodes[].season_number`	Number	Season number.
Episode Number`episodes[].episode_number`	Number	Episode number.
Runtime (minutes)`episodes[].runtime_minutes`	Number	Episode runtime in minutes.
Network or Streaming Service`episodes[].network_or_streaming_service`	Text	Broadcast network or streaming service.

For developers

Run this workflow from your own code. In Studio, turn on Developer mode and create an API key.

cURL

# First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
: "${FOUS_API_KEY:?Set FOUS_API_KEY before running this example}"

curl 'https://api.fous.com/v1/query' \
  --fail-with-body --silent --show-error --max-time 120 \
  -H "Authorization: Bearer $FOUS_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

Is Fous affiliated with TVmaze?

No. Fous is not affiliated with TVmaze. This workflow reads the public tvmaze.com website and returns its data.

How much does it cost?

Each run costs 1 credit. 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; repeating the same request within a day may return the saved result. Fous checks this workflow automatically; it last passed a check on Sep 29, 2026.