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-15&tz=UTC
| Time | Programme | Episode | Category | Length |
|---|---|---|---|---|
| 23:05 | 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 | |
| 00:05 | Ramsay's Hotel HellGordon visits West Dover in Vermont to try to save a dog-friendly hotel that's desperately in need of help. Sandy MacDougall, the owner, runs the F... | Four Seasons Inn | 55m | |
| 01:00 | Ramsay's Hotel HellGordon Ramsay checks into Murphy's Historic Hotel near Sacramento in northern California, where owners Brian, Kevin and Joel are often too distract... | Murphy's Historic Hotel | 55m | |
| 01:55 | GoggleboxThis week on the 'Box: Britain's Got Talent, Celebrity Hunted, Coronation Street, Michael McIntyre's Big Show, One Question, Boarders, The Fear Cli... | S25 E3, Episode 3 | 1h | |
| 02:55 | Our Tiny IslandsStation Island welcomes 10,000 pilgrims every year for a gruelling three-day fast. Iona has a monastic tradition too, but also has a great takeaway... | S2 E2, Episode 2 | 1h | |
| 03:55 | TeleshoppingPresenting the latest products live on television that can be ordered directly. The product range extends from vacuum cleaners and bath towels to s... | 1h 5m | ||
| 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 New Life in the Sun: Where Are They Now?Franny and Fenton, who run a high-tech hotel in southern Spain, feel financial pressures, Zak and Tony face up to the realities of managing a busy ... | 1h | ||
| 09:00 | Renovation NationMatt and Michelle's rundown farmhouse renovation gets started. In North Yorkshire, Naomi and Byron are transforming a Grade I listed mansion into a... | 1h | ||
| 10:00 | Help! We Bought a VillageIn Boivert, Amy and Gary try to take down a wall without using power tools. In Spain, Clare and Frank have a caterpillar problem. | 1h | ||
| 11:00 | A Place in the SunSandra and Dave want a holiday home with a sea view and plenty of outside space for entertaining. Danni Menzies shows them what their £180k can buy... | La Duquesa, Costa del Sol | 1h | |
| 12: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 | |
| 13:00 | A Place in the SunClara and David look for a holiday home in Corralejo. Famous for its white sandy beaches, gorgeous turquoise seas, and year-round warmth, the islan... | Fuerteventura | 1h | |
| 14:00 | Come Dine with MeThis week's competition is in and around Cardiff, where first host, 26-year-old IT architect Anna, hopes to wow her guests with a culinary journey ... | Cardiff: Anna | 30m | |
| 14:30 | Come Dine with MeOn day two in Cardiff, accountant Charlotte's splashes the cash on a menu of luxury ingredients in her bid to win the prize. However, her attempts ... | Cardiff: Charlotte | 30m | |
| 15:00 | Come Dine with MeIn Cardiff, the third host of the week is beautician Claire. On the menu are all of her favourite dishes, but instead of boring old plates Claire i... | Cardiff: Claire | 30m | |
| 15:30 | Come Dine with MeThis week is in and around Cardiff, where next host is sales rep and football referee, Scott, who is playing it safe with his menu of family favour... | Cardiff: Scott | 30m | |
| 16:00 | Come Dine with MeIt is the final night in Cardiff, and restaurateur Giovanni is cooking a menu from his native Italy as he bids to scoop the prize. When the others ... | Cardiff: Giovanni | 30m | |
| 16:30 | A Place in the SunHusband and wife Steve and Dawn first visited Mijas 11 years ago and have wanted to own a holiday home there ever since. Laura Hamilton shows them ... | Mijas | 30m | |
| 17:00 | A Place in the SunEmma and John have fallen in love with the charm of Seville and are looking for a flat in the heart of the city. Jasmine Harman shows Emma and John... | Seville | 1h | |
| 18:00 | A Place in the SunLaura and Nick dream of making a permanent move to Estepona on Spain's Costa del Sol with their beloved dog Poppy. Can Jean Johansson find the perf... | Estepona, Spain | 45m | |
| 18:45 | The Great Celebrity Pottery Throw DownIt's the final, and the celebs create a trifle set and a tricky throwing surprise challenge. Who'll get a taste of sweet success, and who'll get th... | 1h 15m | ||
| 20:00 | Grand DesignsKevin returns to Huddersfield to revisit Chris and Gill's ambitiously converted former woollen mill. Has their meticulous, perfectionist approach s... | 1h | ||
| 21:00 | Geordie CoppersThe coppers face an operational dilemma when a gang's car is spotted on the move. Sergeant Graham is on patrol, but is he at risk of being confused... | 1h | ||
| 22:00 | Ramsay's Hotel HellGordon visits Starkville, Mississippi, to try to rescue the failing Hotel Chester. Despite having over 40 years of experience in the hotel business... | Hotel Chester | 1h | |
| 23:00 | TaskmasterA Taskmaster legend is in the house. All but one of the contestants enjoy a short and steamy train ride. And Nina Conti tries to trick Greg Davies ... | The Oldest I've Ever Looked | 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-15&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-13T00:00:00Z&to=2025-10-14T00:00:00Z"
$ch = curl_init("https://api.tvguideapi.com/v1/channels/ch_cznr38xn/schedule?date=2026-10-15&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-15&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-15", "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-15, the first programme { "data": [ { "id": "ls_qzes7jtw", "channel": "ch_cznr38xn", "start": "2026-10-14T23:05:00Z", "stop": "2026-10-15T00:05:00Z", "title": "Gogglebox", "sub_title": null, "description": "What's the Gogglebox verdict on 'The Celebrity Traitors', 'Tempting Fortune',...", "category": [], "flags": { "new": false, "live": false } } ], "meta": { "count": 26, "date": "2026-10-15", "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.