episodesbydate: Get episodes by date

API: tvmaze.com:tvmaze-api
Endpoint: /shows/{id}/episodesbydate
Response format: application/json
Auth: unknown
Method: GET
Last Status: 200
Latency: 121ms

Description

Returns episodes matching the specified air date. Useful for finding what aired on a particular day or building calendar views. Date format must be YYYY-MM-DD.

From spec: Retrieve all episodes from this show that aired on a specific date.

Usage Tips

- Required query parameter: date (format: YYYY-MM-DD) - Returns empty array if no episodes aired on that date - Timezone is based on the show's network timezone

Parameters (2)

date (string, query, required)

ISO 8601 date (YYYY-MM-DD)

id (integer, path, required)

TVmaze show ID

Examples (1)

Get episodes that aired on June 24, 2013 for Under the Dome probe-gate

Demonstrates filtering episodes by specific air date using query parameter

curl 'https://api.tvmaze.com/shows/1/episodesbydate?date=2013-06-24'
import requests

resp = requests.get(
    "https://api.tvmaze.com/shows/1/episodesbydate",
    params={
        'date': '2013-06-24',
    },
)
data = resp.json()
import zingu_apis

api = zingu_apis.api("tvmaze")
result = api.fetch("shows/{id}/episodesbydate", date="2013-06-24")

for item in result:
    print(item)
const resp = await fetch("https://api.tvmaze.com/shows/1/episodesbydate?date=2013-06-24");
const data = await resp.json();

Probe History

Latency

Status Codes

TimeStatusLatencySize
2026-04-16 00:12:46.217359 200 121ms
2026-04-15 01:20:52.551493 200 182ms
2026-04-14 01:43:41.568953 200 183ms
2026-04-12 14:49:30.269527 200 123ms
2026-04-10 00:59:16.829393 200 84ms
2026-04-09 02:09:31.163573 200 424ms