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 America/New_York 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 America/New_York. The same day from the API: GET /v1/channels/ch_k7myc5f7/schedule?date=2026-10-13&tz=America/New_York
| Time | Programme | Episode | Category | Length |
|---|---|---|---|---|
| 23:26 | Country File: 2021Ellie visits the 'golden triangle' in Gloucestershire, an area famous for daffodils. | Country File: 2021 - The Daffodil Way | Explore | 51m |
| 00:17 | Country File: 2021Tom Heap and Margherita Taylor look at the impact of canals on our countryside. | S33 E15, Canals | Explore | 26m |
| 00:43 | Country File: 2021Sean Fletcher tours the Hambleden Valley in Buckinghamshire. | Country File: 2021 - Hambleden Valley | Explore | 50m |
| 01:33 | Country File: 2021Helen Skelton visits the Nidderdale Area of Outstanding Natural Beauty in North Yorkshire. | Country File: 2021 - Nidderdale | Explore | 49m |
| 02:22 | Country File: 2021John Craven celebrates 50 years as a BBC presenter and his 1,250th episode of Countryfile. | Country File: 2021 - John Craven's Best of Britain | Explore | 47m |
| 03:09 | Country File: 2021Steve Brown goes stargazing in the UK's first designated dark sky reserve. | Country File: 2021 - Cranborne Chase | Explore | 49m |
| 03:58 | Country File: 2021Matt Baker and Charlotte Smith celebrate the 70th anniversary of the Peak District. | Country File: 2021 - White Peak | Explore | 49m |
| 04:47 | Amazing Hotels: Life Beyond the LobbyMonica Galetti and Giles Coren work behind the scenes of an adventure hotel in Iceland. | S4 E1, ION Adventure Hotel, Iceland | Explore | 1h 7m |
| 05:54 | Amazing Hotels: Life Beyond the LobbyMonica and Giles work on a historic hotel situated in the island of perpetual springtime. | S4 E2, Reid's Palace, Madeira | Explore | 1h 7m |
| 07:01 | Amazing Hotels: Life Beyond the LobbyMonica and Giles work in a glass-fronted hotel in the historic Croatian town of Rovinj. | S4 E3, Grand Park Rovinj, Croatia | Explore | 1h 7m |
| 08:08 | Amazing Hotels: Life Beyond the LobbyMonica and Giles travel to a hotel in Copenhagen that aims to deliver complete happiness. | S4 E4, Nimb Hotel, Copenhagen | Explore | 1h 7m |
| 09:15 | Amazing Hotels: Life Beyond the LobbyGiles Coren and Monica Galetti visit a hotel in a Middle Eastern desert. | S4 E5, Qasr Al Sarab Desert Resort | Explore | 1h 7m |
| 10:22 | Amazing Hotels: Life Beyond the LobbyMonica Galetti and Giles Coren visit London's most expensive hotel, the Lanesborough. | S4 E6, The Lanesborough, London | Explore | 1h 7m |
| 11:29 | Amazing Hotels: Life Beyond the LobbyMonica Galetti and Rob Rinder become staff for Sir Richard Branson at his hotel in Morocco. | S5 E1, Kasbah Tamadot, Morocco | Explore | 1h 8m |
| 12:37 | Amazing Hotels: Life Beyond the LobbyMonica and Rob learn the secrets to running a hotel on a remote island in the Maldives. | S5 E2, Joali, Maldives | Explore | 1h 7m |
| 13:44 | Amazing Hotels: Life Beyond the LobbyMonica and Rob experience Arctic life in a 200-year-old preserved fishing village. | S5 E3, Nusfjord Arctic Resort, Norway | Explore | 1h 7m |
| 14:51 | Amazing Hotels: Life Beyond the LobbyMonica and Rob travel into the highlands of Sri Lanka and discover Ceylon Tea Trails hotel. | S5 E4, Ceylon Tea Trails, Sri Lanka | Explore | 1h 7m |
| 15:58 | Amazing Hotels: Life Beyond the LobbyMonica and Rob work behind the scenes of a wildlife reserve hotel in the African bush. | S5 E5, Phinda Game Reserve, South Africa | Explore | 1h 7m |
| 17:05 | Amazing Hotels: Life Beyond the LobbyMonica and Rob work behind the scenes of a luxury hotel that resembles an Italian village. | S5 E6, Borgo Egnazia, Italy | Explore | 1h 7m |
| 18:12 | Amazing Hotels: Life Beyond the LobbyMonica and Rob are in Scotland at Glenapp Castle, where guests visit wilderness in luxury. | S5 E7, Glenapp Castle, Scotland | Explore | 1h 7m |
| 19:19 | Amazing Hotels: Life Beyond the LobbyMonica and Rob visit Hotel Hubertus - a spectacular Alpine resort run by a local family. | S5 E8, Hotel Hubertus, Italian Alps | Explore | 1h 7m |
| 20:26 | Fake or Fortune?Can the team prove a flower picture is by the pioneer of abstract art, Piet Mondrian? | S12 E1, Mondrian | Explore | 1h 5m |
| 21:31 | Fake or Fortune?Could a beautiful landscape be a lost work by Canadian impressionist Helen McNicoll? | S12 E2, Helen McNicoll | Explore | 1h 4m |
| 22:35 | Fake or Fortune?Can the team prove that a guitar and piano were once owned by John Lennon and Ronnie Wood? | S12 E3, Music Memorabilia | Explore | 1h 2m |
| 23:37 | Fake or Fortune?Can the team prove a landscape painting is by influential French artist, Camille Corot? | S12 E4, Corot | Explore | 1h 4m |
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_k7myc5f7/schedule?date=2026-10-13&tz=America/New_York" # what is on now, and next curl -H "Authorization: Bearer $TVG_KEY" \ "https://api.tvguideapi.com/v1/channels/ch_k7myc5f7/now" # any past day (Archive plan) curl -H "Authorization: Bearer $TVG_KEY" \ "https://api.tvguideapi.com/v1/channels/ch_k7myc5f7/history?from=2025-10-12T00:00:00Z&to=2025-10-13T00:00:00Z"
$ch = curl_init("https://api.tvguideapi.com/v1/channels/ch_k7myc5f7/schedule?date=2026-10-13&tz=America/New_York"); 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_k7myc5f7/schedule?date=2026-10-13&tz=America/New_York", { 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_k7myc5f7/schedule", params={"date": "2026-10-13", "tz": "America/New_York"}, headers={"Authorization": f"Bearer {os.environ['TVG_KEY']}"}, ) for slot in r.json()["data"]: print(slot["start"], slot["title"])
// GET /v1/channels/ch_k7myc5f7/schedule?date=2026-10-13, the first programme { "data": [ { "id": "ls_yd38ntq2", "channel": "ch_k7myc5f7", "start": "2026-10-13T03:26:00Z", "stop": "2026-10-13T04:17:00Z", "title": "Country File: 2021", "sub_title": "Country File: 2021 - The Daffodil Way", "description": "Ellie visits the 'golden triangle' in Gloucestershire, an area famous for daf...", "category": [ "explore" ], "flags": { "new": false, "live": false } } ], "meta": { "count": 25, "date": "2026-10-13", "tz": "America/New_York" } }
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.
A free key in a minute, with Google. No card. Yesterday and today on every channel in 155 countries.