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_cznr38xn/schedule?date=2026-10-10&tz=UTC
| Time | Programme | Episode | Category | Length |
|---|---|---|---|---|
| 23:05 | GoggleboxWhat do Britain's sharpest armchair critics think of this week's TV? With 'The Celebrity Traitors', 'Strictly Come Dancing', 'Wonka's The Golden Ti... | S28 E5, Episode 5 | Series, Reality | 1h |
| 00:05 | TaskmasterRichard Ayoade threatens to destroy the set, Nina Conti wields a shovel and Chloe Petts has a day full of mishaps. Meanwhile, Matt Lucas gets busy ... | To Void an Oblong | Series, Comedy | 1h |
| 01:05 | Tempting FortuneDivides form as some of the group splash out on a luxury spa break. A fast-food fix proves too finger lickin' good to resist. And the Fortune Seeke... | S3 E3, Episode 3 | 1h | |
| 01:10 | Tempting FortuneDivides form as some of the group splash out on a luxury spa break. A fast-food fix proves too finger lickin' good to resist. And the Fortune Seeke... | S3 E3, Episode 3 | Series, Competition reality | 1h |
| 02:05 | The Great Celebrity Pottery Throw DownIt's all to clay for, as our celebs make garden gnomes and face a handle-making challenge. Who handles the pressure to make it through to the final... | S1 E4, Episode 4 | 1h 5m | |
| 02:10 | The Great Celebrity Pottery Throw DownIt's all to clay for, as our celebs make garden gnomes and face a handle-making challenge. Who handles the pressure to make it through to the final... | S1 E4, Episode 4 | Series, Competition reality | 1h |
| 03:10 | Devon and CornwallLesley Perrett's on a mission to bring the Longwool sheep back from the brink of extinction. Landscape managers Steve and Jamie prepare the island ... | S2 E4, Episode 4 | Series, Documentary | 50m |
| 04:00 | TeleshoppingPresenting the latest products live on television that can be ordered directly. The product range extends from vacuum cleaners and bath towels to s... | Shopping, Consumer | 1h | |
| 05:00 | TeleshoppingPresenting the latest products live on television that can be ordered directly. The product range extends from vacuum cleaners and bath towels to s... | 3h | ||
| 08:00 | A Place in the SunBelinda and Alan from Essex have been dreaming of a holiday home on Spain's Costa del Sol for years, and have now decided to buy around the pretty ... | La Cala de Mijas | 35m | |
| 08:35 | A Place in the SunSara Damergi is tasked with finding a property for Jaazzmina and Mark, who want to create a remote Spanish smallholding and wellness retreat in the... | Almería, Spain | 1h | |
| 09:35 | A Place in the SunJonnie Irwin is house hunting around the beautiful hill-top town of Cómpeta, Andalucía, with Michael and Seamus from Northern Ireland, who want a h... | Cómpeta, Andalucía | 1h | |
| 10:35 | Come Dine with MeDrinks brand ambassador Dan hopes that his classic Greek grub will make for a memorable first night. But some of the guests struggle to get a word in. | Hull: Dan | 25m | |
| 11:00 | Come Dine with MeComputer fanatic Matt hosts the second night, with culinary cock-ups, revelations of scoffing sofas, and sumo shenanigans on the menu. | Hull: Matt | 30m | |
| 11:30 | Come Dine with MeDog-walking entrepreneur Jordanna hosts a Mexican-themed evening featuring culinary compliments, offers of feet-kissing and some unwanted table gue... | Hull: Jordanna | 30m | |
| 12:00 | Come Dine with MeJayne - the self-proclaimed number one florist in Hull - hosts the fourth night and gives her guests a taste of Spain with her food, flamenco and f... | Hull: Jayne | 30m | |
| 12:30 | Come Dine with MeIn Doncaster, business manager Tony serves up some countryside cuisine on the final night, featuring hit-and-miss food, dirty cutlery and a wolf-wh... | Hull: Tony | 30m | |
| 13:00 | Couples Come Dine with MeOn the South Coast, three rival couples put their hosting skills to the test, in a week featuring experimental flavour combinations, banjo playing ... | S2016 E20, South Coast | 1h | |
| 14:00 | George Clarke's Amazing Spaces: First HomeGeorge discovers a unique floating home made from a repurposed shipping container, an impressive four-homes-in-one in the Netherlands, and some cle... | S1 E4, Episode 4 | 1h | |
| 15:00 | A Place in the SunLaura Hamilton is helping Susan and Ainsley from Cardiff find the perfect holiday home around Mijas on Spain's Costa del Sol. Laura shows them five... | Mijas | 1h | |
| 16:00 | A Place in the SunDiane and John have holidayed on Spain's Costa Cálida for many years and now want to buy their very own property there. Craig Rowe shows them the f... | S2025 E28, Costa Calida | 1h | |
| 17:00 | A Place in the SunNat and Dave have been visiting Lanzarote twice a year for many years. Now they are ready to buy a holiday home on Lanzarote, a place they visit tw... | Lanzarote | 1h | |
| 18:00 | A Place in the SunEdith and William dream of owning a bolthole in sunny Spain to escape the Scottish winters and enjoy with their family. Lucy Alexander shows them T... | Torrevieja, Spain | 1h | |
| 19:00 | Location, Location, LocationIn Warwickshire, can Isla and Luke overlook a cemetery to call a new house home? And Jan and Jon are treated to a property plethora of beams, snugs... | S46 E3, Episode 3 | 1h | |
| 20:00 | Grand DesignsJana and Rory's conversion of an old driving test centre in Edinburgh into sleek upside-down living has stalled over the years. With drive and dete... | S28 E4, Episode 4 | 1h | |
| 21:00 | American Pie: The WeddingJim and Michelle are getting married and Jim struggles to win over his future in-laws and deal with his embarrassing dad. Meanwhile, Stifler isn't ... | 2h | ||
| 23:00 | GoggleboxWhat's the Gogglebox verdict on 'The Celebrity Traitors', 'Tempting Fortune', 'Strictly', 'War', 'Prue Leith's Cotswolds Kitchen', 'Buckingham Pala... | S28 E6, Episode 6 | 1h |
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_cznr38xn/schedule?date=2026-10-10&tz=UTC" # what is on now, and next curl -H "Authorization: Bearer $TVG_KEY" \ "https://api.tvguideapi.com/v1/channels/ch_cznr38xn/now" # any past day (Archive plan) curl -H "Authorization: Bearer $TVG_KEY" \ "https://api.tvguideapi.com/v1/channels/ch_cznr38xn/history?from=2025-10-12T00:00:00Z&to=2025-10-13T00:00:00Z"
$ch = curl_init("https://api.tvguideapi.com/v1/channels/ch_cznr38xn/schedule?date=2026-10-10&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_cznr38xn/schedule?date=2026-10-10&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_cznr38xn/schedule", params={"date": "2026-10-10", "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_cznr38xn/schedule?date=2026-10-10, the first programme { "data": [ { "id": "ls_bgx7nz94", "channel": "ch_cznr38xn", "start": "2026-10-09T23:05:00Z", "stop": "2026-10-10T00:05:00Z", "title": "Gogglebox", "sub_title": null, "description": "What do Britain's sharpest armchair critics think of this week's TV? With 'Th...", "category": [ "series", "reality", "comedy", "entertainment" ], "flags": { "new": false, "live": false } } ], "meta": { "count": 27, "date": "2026-10-10", "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 | Sunday 12 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.