API reference/Movies & TV/TV Schedule

TV Schedule

starterLive data

Episodes airing today (or a date) in a country, prime time by default.

GET/api/v1/movies/schedule

Data source

  • TVmaze APITVmaze · CC-BY-SA-4.0 · updates Continuous

Query parameters

ParameterDescriptionTry value
country
string
ISO code (default US)
date
date
YYYY-MM-DD
primetime
boolean
false for the full day
apikey
string required
Your API key. Can also be sent as the X-API-Key header.demo key used here

Response envelope

Success: { data, meta: { sources, fetchedAt, cached } }. Errors: { error: { code, message } } with HTTP 400, 401, 404, 502, 503 or 504.