Get all episodes for a specific show, ordered by season and episode number. Returns comprehensive episode data including episode names, air dates, runtimes, summaries, and images. This is the endpoint to call when you need a complete episode guide for a show. Results are grouped by season implicitly through the ordering.
From spec: Returns all episodes for a show.
Usage Tips
- Episodes are sorted by season then episode number
- Specials typically have season=0
- Check 'airdate' field for when episodes premiered
- Not all episodes have summaries or images available
Parameters (2)
id(integer, path, required)
Show ID
specials(integer, query, optional)
Include special episodes (1 = yes)
Constraints: {'enum': [0, 1]}
Examples (4)
Get episodes for show ID 1curl
Demonstrates calling /shows/{id}/episodes
curl 'https://api.tvmaze.com/shows/1/episodes'
import requests
resp = requests.get("https://api.tvmaze.com/shows/1/episodes")
data = resp.json()
import zingu_apis
api = zingu_apis.api("tvmaze")
result = api.fetch("shows/{id}/episodes")
for item in result:
print(item)
const resp = await fetch("https://api.tvmaze.com/shows/1/episodes");
const data = await resp.json();
Get episodes for show ID 82 (Game of Thrones)curl
Demonstrates calling /shows/{id}/episodes
curl 'https://api.tvmaze.com/shows/82/episodes'
import requests
resp = requests.get("https://api.tvmaze.com/shows/82/episodes")
data = resp.json()
import zingu_apis
api = zingu_apis.api("tvmaze")
result = api.fetch("shows/{id}/episodes")
for item in result:
print(item)
const resp = await fetch("https://api.tvmaze.com/shows/82/episodes");
const data = await resp.json();
Get episodes for show ID 169 (Breaking Bad)curl
Demonstrates calling /shows/{id}/episodes
curl 'https://api.tvmaze.com/shows/169/episodes'
import requests
resp = requests.get("https://api.tvmaze.com/shows/169/episodes")
data = resp.json()
import zingu_apis
api = zingu_apis.api("tvmaze")
result = api.fetch("shows/{id}/episodes")
for item in result:
print(item)
const resp = await fetch("https://api.tvmaze.com/shows/169/episodes");
const data = await resp.json();