73.8M 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_k8adfk78/schedule?date=2026-10-12&tz=America/New_York
| Time | Programme | Episode | Category | Length |
|---|---|---|---|---|
| 23:44 | Antarctica: The End of the EarthIcebergs inch their way through miles and thousands of years to be born as an island. | Antarctica: The End of the Earth: Icebergs | 1h 2m | |
| 00:46 | Wild CanadaGiant whales, lush rainforests, and thriving heritage shape Canada's rich nature. | S1 E1, The Eternal Frontier | 1h | |
| 01:46 | Wild CanadaSalmon, bears, and eagles shape life between Canada's Pacific coast and the Rockies. | S1 E2, The Wild West | 1h 3m | |
| 02:49 | Wild CanadaVast forests, open grasslands and countless lakes shape Canada's heartland. | S1 E3, The Heartland | 1h 1m | |
| 03:50 | Wild CanadaIce is home to polar bears - but warming oceans turn their hunting ground to water. | S1 E4, Ice Edge | 1h 1m | |
| 04:51 | Grasslands: North America's Hidden WildernessThe Northern Great Plains: little known, stunning, and deeply endangered. | 59m | ||
| 05:50 | Crown of the ContinentGrizzlies, wolves and cougars roam Montana's rugged, pristine Glacier National Park. | 1h 4m | ||
| 06:55 | YosemiteExplore Yosemite to discover how climate change affects the valley's majestic beauty. | 1h 1m | ||
| 07:56 | The ColoradoEagles, pumas, cranes and other creatures seek sustenance from the Colorado River. | 1h 5m | ||
| 09:01 | Kalahari: Wilderness Without WaterExamine the plants and animals that have adapted to the harsh environment of the Kalahari. | 1h 5m | ||
| 10:05 | KalahariWatch as the Kalahari swarms with life brought forth by a brief season of sudden storms. | Kalahari: The Great Thirstland | 1h 1m | |
| 11:06 | KalahariCapture the interaction between the Kalahari Desert and the Okavango River delta. | Kalahari: The Flooded Desert | 2h 6m | |
| 13:13 | Saguaro: Sentinel of the DesertUndisturbed the saguaro cactus can grow to 60 feet, weigh 10 tons and live 150 years. | 1h 5m | ||
| 14:17 | Deep JungleGo into the depths of the Amazon, home to millions of marvelous species. | Deep Jungle: Monsters of the Forest | 1h 2m | |
| 15:19 | Deep JungleExplore primates in Central African Republic, Guatemala and Cambodia. | Deep Jungle: The Beast Within | 1h 2m | |
| 16:21 | Great Wood of CaledonFilmmaker Hugh Miles presents a lyrical portrait of Scotland's Caledonian Forest. | 1h 5m | ||
| 17:26 | IrelandMillions of years ago, the advance and retreat of ice shaped Ireland. | 1h 3m | ||
| 18:29 | Wild Way of the VikingsExperience the natural world through the eyes of the Vikings. From NATURE. | 1h 1m | ||
| 19:30 | Forces of the WildThe story of the origin of our solar system and the formation of our planet. | Forces of the Wild I: In the Beginning | 1h 2m | |
| 20:32 | Forces of the WildExplore the importance of the atmosphere and oceans both in creating and destroying life. | Forces of the Wild II: Perpetual Motion | 1h 4m | |
| 21:36 | Forces of the WildInvestigate the Earth's most important neighbors: the sun and the moon. | Forces of the Wild III: Heavenly Partners | 1h 2m | |
| 22:38 | Living VolcanoesUncover the variety of activity occuring on the slopes of active volcanoes. From Nature. | 1h 1m | ||
| 23:40 | Krakatoa: Day That Shook the WorldThe 1883 eruption of volcano Krakatoa. | 2h 10m |
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_k8adfk78/schedule?date=2026-10-12&tz=America/New_York" # what is on now, and next curl -H "Authorization: Bearer $TVG_KEY" \ "https://api.tvguideapi.com/v1/channels/ch_k8adfk78/now" # any past day (Archive plan) curl -H "Authorization: Bearer $TVG_KEY" \ "https://api.tvguideapi.com/v1/channels/ch_k8adfk78/history?from=2025-10-13T00:00:00Z&to=2025-10-14T00:00:00Z"
$ch = curl_init("https://api.tvguideapi.com/v1/channels/ch_k8adfk78/schedule?date=2026-10-12&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_k8adfk78/schedule?date=2026-10-12&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_k8adfk78/schedule", params={"date": "2026-10-12", "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_k8adfk78/schedule?date=2026-10-12, the first programme { "data": [ { "id": "ls_cnbad9dn", "channel": "ch_k8adfk78", "start": "2026-10-12T03:44:22Z", "stop": "2026-10-12T04:46:10Z", "title": "Antarctica: The End of the Earth", "sub_title": "Antarctica: The End of the Earth: Icebergs", "description": "Icebergs inch their way through miles and thousands of years to be born as an...", "category": [], "flags": { "new": false, "live": false } } ], "meta": { "count": 23, "date": "2026-10-12", "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 | 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 150 countries.