72.1M listings
Every country's schedule under one key, one shape and one set of ids.
GET /v1/now
What every channel in a country is showing this minute, with the next programme after it.
MIT, no lock-in
Every lab tool reads only the public API with your own key, so it runs on the free key.
Working normally
Checked every minute from outside our own servers.
The full schedule in UTC time, what is on now and next, and the same data in your app with one call. Search any past day on the Archive plan.
All times UTC. The same day from the API: GET /v1/channels/ch_zk8k4fzq/schedule?date=2026-10-19&tz=UTC
| Time | Programme | Episode | Category | Length |
|---|---|---|---|---|
| 23:05 | Secret Nazi BasesThe Future of Evil: Built in 1934, Ordensburg Vogelsang, a virtual Nazi Castle was constructed with the intention of building the New German; elite... | S2 E7, The Future of Evil | 1h | |
| 00:05 | Secret Nazi BasesThe Secrets of Nazi Future Tech: Hidden in a remote mountainous forest is a structure nicknamed the Fly Trap or Hitler's Stonehenge. Researchers st... | S2 E4, The Secrets of Nazi Future Tech | 55m | |
| 01:00 | Secret Nazi BasesFuelling Evil: Outside the town of Politz lie the ruins of what was once one of Germany's most important assets - a place that kept the German war ... | S2 E5, Fuelling Evil | 55m | |
| 01:55 | Secret Nazi BasesSecrets of Hitler's Castle: When the Nazis took Ksiaz Castle, it wasn't for the view. Secret staircases and lifts were built, while underneath, a v... | S2 E6, Secrets of Hitler's Castle | 55m | |
| 02:50 | Secret Nazi BasesThe Future of Evil: Built in 1934, Ordensburg Vogelsang, a virtual Nazi Castle was constructed with the intention of building the New German; elite... | S2 E7, The Future of Evil | 45m | |
| 03:35 | Secret Nazi BasesThe Secrets of Nazi Future Tech: Hidden in a remote mountainous forest is a structure nicknamed the Fly Trap or Hitler's Stonehenge. Researchers st... | S2 E4, The Secrets of Nazi Future Tech | 45m | |
| 04:20 | Secret Nazi BasesFuelling Evil: Outside the town of Politz lie the ruins of what was once one of Germany's most important assets - a place that kept the German war ... | S2 E5, Fuelling Evil | 50m | |
| 05:10 | Great Coastal Railway JourneysScarborough to Bridlington: Michael Portillo is in the North Yorkshire seaside resort of Scarborough to explore one of the greatest royal fortresse... | S2 E8, Scarborough to Bridlington | 25m | |
| 05:35 | Great Coastal Railway JourneysCarlingford to Dublin: Michael Portillo makes his way from the vast beaches of the Carlingford Peninsula to the capital of the Republic of Ireland,... | S2 E14, Carlingford to Dublin | 25m | |
| 06:00 | TeleshoppingShopping from Home. | 3h | ||
| 09:00 | James May's Toy StoriesScalextric: James May continues his quest to show what is possible with old-fashioned toys - here he tries to build the world's biggest Scalextric ... | S1 E4, Scalextric | 1h | |
| 10:00 | James May's Toy StoriesLego: James May tackles supersize projects using traditional toys - in one of his biggest undertakings yet, James here attempts to build a full-siz... | S1 E5, Lego | 1h | |
| 11:00 | James May's Toy StoriesHornby: James May subjects traditional toys to supersize challenges - here he attempts to build the longest ever model railway track - a whopping t... | S1 E6, Hornby | 1h | |
| 12:00 | James May's Toy Stories Special......Action Man at the Speed of Sound. The presenter attempts to see if it's possible for Action Man to do what no toy has ever managed before - trav... | 1h | ||
| 13:00 | James May's Toy StoriesScalextric: James May continues his quest to show what is possible with old-fashioned toys - here he tries to build the world's biggest Scalextric ... | S1 E4, Scalextric | 1h | |
| 14:00 | James May's Toy StoriesLego: James May tackles supersize projects using traditional toys - in one of his biggest undertakings yet, James here attempts to build a full-siz... | S1 E5, Lego | 1h | |
| 15:00 | James May's Toy StoriesHornby: James May subjects traditional toys to supersize challenges - here he attempts to build the longest ever model railway track - a whopping t... | S1 E6, Hornby | 1h | |
| 16:00 | James May's Toy Stories Special......Action Man at the Speed of Sound. The presenter attempts to see if it's possible for Action Man to do what no toy has ever managed before - trav... | 1h | ||
| 17:00 | Some Mothers Do 'Ave 'EmThe Psychiatrist: Michael Crawford in the classic comedy. Convinced he is a failure, Frank visits a psychiatrist. By the end of his story, the doct... | S1 E6, The Psychiatrist | 40m | |
| 17:40 | Some Mothers Do 'Ave 'EmThe Employment Exchange: More fun with Michael Crawford's immortal comic creation. The new manager of the labour exchange refuses to believe that F... | S1 E7, The Employment Exchange | 40m | |
| 18:20 | Top of the Pops27/04/89: Featuring Natalie Cole, Fine Young Cannibals, The Beatmasters With Merlin, and Bangles. Gary Davies presents. S1989 Ep4 | 40m | ||
| 19:00 | Top of the Pops25/05/89: Featuring Tone Loc, Robert Palmer, Cappella, and Wasp. Simon Mayo presents. S1989 Ep8 | 40m | ||
| 19:40 | Top of the Pops01/06/89: Featuring Natalie Cole, Double Trouble & Rebel Mc, Neneh Cherry, and Fuzzbox. Gary Davies and Anthea Turner present. S1989 Ep9 | 40m | ||
| 20:20 | Top of the Pops08/06/89: Featuring Cliff Richard, The Beautiful South, D Mob Featuring Lrs, and Jason Donovan. Nicky Campbell presents. S1989 Ep10 | 40m | ||
| 21:00 | Some Mothers Do 'Ave 'EmThe Psychiatrist: Michael Crawford in the classic comedy. Convinced he is a failure, Frank visits a psychiatrist. By the end of his story, the doct... | S1 E6, The Psychiatrist | 40m | |
| 21:40 | Some Mothers Do 'Ave 'EmThe Employment Exchange: More fun with Michael Crawford's immortal comic creation. The new manager of the labour exchange refuses to believe that F... | S1 E7, The Employment Exchange | 40m | |
| 22:20 | Top of the Pops27/04/89: Featuring Natalie Cole, Fine Young Cannibals, The Beatmasters With Merlin, and Bangles. Gary Davies presents. S1989 Ep4 | 40m | ||
| 23:00 | Top of the Pops25/05/89: Featuring Tone Loc, Robert Palmer, Cappella, and Wasp. Simon Mayo presents. S1989 Ep8 | 40m | ||
| 23:40 | Top of the Pops01/06/89: Featuring Natalie Cole, Double Trouble & Rebel Mc, Neneh Cherry, and Fuzzbox. Gary Davies and Anthea Turner present. S1989 Ep9 | 40m |
Copy, add your key, run. The free key reads yesterday and today on every channel, 500 calls a day.
curl -H "Authorization: Bearer $TVG_KEY" \ "https://api.tvguideapi.com/v1/channels/ch_zk8k4fzq/schedule?date=2026-10-19&tz=UTC" # what is on now, and next curl -H "Authorization: Bearer $TVG_KEY" \ "https://api.tvguideapi.com/v1/channels/ch_zk8k4fzq/now" # any past day (Archive plan) curl -H "Authorization: Bearer $TVG_KEY" \ "https://api.tvguideapi.com/v1/channels/ch_zk8k4fzq/history?from=2025-10-13T00:00:00Z&to=2025-10-14T00:00:00Z"
$ch = curl_init("https://api.tvguideapi.com/v1/channels/ch_zk8k4fzq/schedule?date=2026-10-19&tz=UTC"); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => ["Authorization: Bearer " . getenv("TVG_KEY")], ]); foreach (json_decode(curl_exec($ch), true)["data"] as $slot) { echo $slot["start"], " ", $slot["title"], "\n"; }
const r = await fetch("https://api.tvguideapi.com/v1/channels/ch_zk8k4fzq/schedule?date=2026-10-19&tz=UTC", { headers: { Authorization: `Bearer ${process.env.TVG_KEY}` }, }); const { data } = await r.json(); data.forEach(s => console.log(s.start, s.title, s.flags.live ? "LIVE" : ""));
import os, requests r = requests.get( "https://api.tvguideapi.com/v1/channels/ch_zk8k4fzq/schedule", params={"date": "2026-10-19", "tz": "UTC"}, headers={"Authorization": f"Bearer {os.environ['TVG_KEY']}"}, ) for slot in r.json()["data"]: print(slot["start"], slot["title"])
// GET /v1/channels/ch_zk8k4fzq/schedule?date=2026-10-19, the first programme { "data": [ { "id": "ls_mwg47z5j", "channel": "ch_zk8k4fzq", "start": "2026-10-18T23:05:00Z", "stop": "2026-10-19T00:05:00Z", "title": "Secret Nazi Bases", "sub_title": null, "description": "The Future of Evil: Built in 1934, Ordensburg Vogelsang, a virtual Nazi Castl...", "category": [], "flags": { "new": false, "live": false } } ], "meta": { "count": 29, "date": "2026-10-19", "tz": "UTC" } }
What was on, on any date we hold: for research, catch-up, clip finding or proving a broadcast. Any window up to 31 days with /v1/channels/{id}/history on the Archive plan.
| Time | Monday 13 October 2025 | Category |
|---|---|---|
| Nothing held for that day. Try another date. | ||
8 calls cover a channel from its details to its past. Each one opens in the documentation with Try it.
A free key in a minute, with Google. No card. Yesterday and today on every channel in 155 countries.