TVmaze's API at https://api.tvmaze.com covers TV shows, episodes, cast, and daily schedules.
None, limited to about 20 calls every 10 seconds per IP.
Full reference: https://www.tvmaze.com/api
Returns the best match.
curl "https://api.tvmaze.com/singlesearch/shows?q=severance"{
"id": 44933,
"url": "https://www.tvmaze.com/shows/44933/severance",
"name": "Severance",
"type": "Scripted",
"language": "English",
"genres": [
"Drama",
"Science-Fiction"
],
"status": "Running",
"runtime": null,
"averageRuntime": 49,
"premiered": "2022-02-18",
"ended": null,
"officialSite": "https://tv.apple.com/show/severance/umc.cmc.1srk2goyh2q2zdxcx605w8vtx",
"schedule": {
"time": "",
"days": [
"Friday"
]
},
"rating": {
"average": 7.6
},
"weight": 100
}82 is Game of Thrones' TVmaze id.
curl https://api.tvmaze.com/shows/82/episodes[
{
"id": 4952,
"url": "https://www.tvmaze.com/episodes/4952/game-of-thrones-1x01-winter-is-coming",
"name": "Winter is Coming",
"season": 1,
"number": 1,
"type": "regular",
"airdate": "2011-04-17",
"airtime": "21:00",
"airstamp": "2011-04-18T01:00:00+00:00",
"runtime": 60,
"rating": {
"average": 8.2
},
"image": {
"medium": "https://static.tvmaze.com/uploads/images/medium_landscape/478/1195111.jpg",
"original": "https://static.tvmaze.com/uploads/images/original_untouched/478/1195111.jpg"
},
"_links": {
"self": {
"href": "https://api.tvmaze.com/episodes/4952"
},
"show": {
"href": "https://api.tvmaze.com/shows/82",
"name": "Game of Thrones"
}
}
},
{
"id": 4953,
"url": "https://www.tvmaze.com/episodes/4953/game-of-thrones-1x02-the-kingsroad",
"name": "The Kingsroad",
"season": 1,
"number": 2,
"type": "regular",
"airdate": "2011-04-24",
"airtime": "21:00",
"airstamp": "2011-04-25T01:00:00+00:00",
"runtime": 60,
"rating": {
"average": 8.2
},
"image": {
"medium": "https://static.tvmaze.com/uploads/images/medium_landscape/478/1195110.jpg",
"original": "https://static.tvmaze.com/uploads/images/original_untouched/478/1195110.jpg"
},
"summary": "<p>An incident on the Kingsroad threatens Eddard and Robert's friendship. Jon and Tyrion travel to the Wall, where they discover that the reality of the Night's Watch may not match the heroic image of it.</p>",
"_links": {
"self": {
"href": "https://api.tvmaze.com/episodes/4953"
},
"show": {
"href": "https://api.tvmaze.com/shows/82",
"name": "Game of Thrones"
}
}
}
]curl "https://api.tvmaze.com/schedule?country=US"[
{
"id": 3724217,
"url": "https://www.tvmaze.com/episodes/3724217/the-pulse-2026-09-22-episode-188",
"name": "Episode 188",
"season": 2026,
"number": 188,
"type": "regular",
"airdate": "2026-09-22",
"airtime": "04:00",
"airstamp": "2026-09-23T08:00:00+00:00",
"runtime": 60,
"rating": {
"average": null
},
"image": null,
"summary": null,
"show": {
"id": 15680,
"url": "https://www.tvmaze.com/shows/15680/the-pulse",
"name": "The Pulse",
"type": "News",
"language": "English",
"genres": [],
"status": "Running",
"runtime": 60,
"averageRuntime": 60,
"premiered": "2015-08-13",
"ended": null,
"officialSite": "https://www.bloomberg.com/btv/series/the-pulse-francine-lacqua",
"schedule": {
"time": "04:00",
"days": [
"Monday",
"Tuesday"
]
},
"rating": {
"average": null
},
"weight": 72
},
"_links": {
"self": {
"href": "https://api.tvmaze.com/episodes/3724217"
},
"show": {
"href": "https://api.tvmaze.com/shows/15680",
"name": "The Pulse"
}
}
},
{
"id": 3718463,
"url": "https://www.tvmaze.com/episodes/3718463/way-too-early-2026-09-23-episode-185",
"name": "Episode 185",
"season": 2026,
"number": 185,
"type": "regular",
"airdate": "2026-09-23",
"airtime": "05:00",
"airstamp": "2026-09-23T09:00:00+00:00",
"runtime": 60,
"rating": {
"average": null
},
"image": null,
"show": {
"id": 15308,
"url": "https://www.tvmaze.com/shows/15308/way-too-early",
"name": "Way Too Early",
"type": "News",
"language": "English",
"genres": [],
"status": "Running",
"runtime": 60,
"averageRuntime": 59,
"premiered": "2009-07-27",
"ended": null,
"officialSite": "http://www.msnbc.com/way-too-early",
"schedule": {
"time": "05:00",
"days": [
"Monday",
"Tuesday"
]
},
"rating": {
"average": null
},
"weight": 79
},
"_links": {
"self": {
"href": "https://api.tvmaze.com/episodes/3718463"
},
"show": {
"href": "https://api.tvmaze.com/shows/15308",
"name": "Way Too Early"
}
}
}
]