Free key: real listings for yesterday and today, 500 calls a day, no card148 countriesGet yours in 30 seconds
tvguideapi

Last 30 days

API uptimefrom the monitorIncidentsfrom the monitor
All systems

Working normally

Checked every minute from outside our own servers.

Documentation/Shows and episodes

Where an episode aired

Every showing of one TV episode we hold, the first run and every repeat, on every channel.

Paid plansData from 2010
GEThttps://api.tvguideapi.com/v1/episodes/{id}/airings
Try itRuns the real call with your key
200 OK

Parameters

ParameterInTypeRequiredDescriptionExample
idpathstringrequiredThe episode id.ep_610mmeyh
cursorquerystringoptionalThe cursor from the previous answer's meta.next. See Paging and fields.

Request

curl -H "Authorization: Bearer $TVG_KEY" \
  "https://api.tvguideapi.com/v1/episodes/ep_610mmeyh/airings"

Sample response

{
    "data": [
        {
            "channel": "ch_jw83a3xg",
            "country": "GB",
            "start": "2026-10-08T19:00:00Z",
            "episode_id": "ep_610mmeyh",
            "kind": "first-run"
        },
        {
            "channel": "ch_e5n9wc2j",
            "country": "US",
            "start": "2026-10-09T23:00:00Z",
            "episode_id": "ep_610mmeyh",
            "kind": "repeat"
        }
    ],
    "meta": {
        "count": 2,
        "next": null,
        "took_ms": 41
    }
}

Errors