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_b77v4fw1/schedule?date=2026-10-10&tz=UTC
| Time | Programme | Episode | Category | Length |
|---|---|---|---|---|
| 22:50 | Lennox Lewis: The Untold StoryThe incredible story of Lennox Lewis, who rose from humble beginnings in London's West Ham to become regarded as one of the greatest heavyweight bo... | 2h | ||
| 00:50 | QPR: The Four Year PlanDocumentary charting Queens Park Rangers' return from the brink of bankruptcy, featuring boardroom battles and private chats from the larger-than-l... | 1h 50m | ||
| 02:40 | DanielNew & Exclusive. The story of Daniel Northcott. When a coming-of-age adventure collides with an Ancient Mayan curse, a boy embarks on a quest to pu... | 1h 20m | ||
| 04:00 | Discovering: James CoburnA profile of James Coburn, the tough-guy actor in films that included Our Man Flint and The Magnificent Seven, who won an Academy Award in 1998 for... | 1h | ||
| 05:00 | Discovering: Peter O'TooleA fascinating look at the life and work of Peter O'Toole, the late stage and film actor who shot to fame by playing TE Lawrence in Lawrence of Arab... | 1h | ||
| 06:00 | Discovering: Joan FontaineAn intimate portrait of Joan Fontaine, the Academy Award-winning actress who appeared in such films as Rebecca (1940), Suspicion (1941), Jane Eyre ... | 1h | ||
| 07:00 | Christopher Nolan: The DirectorsChristopher Nolan: An iconic director with a portfolio of blockbuster films, explore the life and career of silver-screen genius Christopher Nolan.... | 1h | ||
| 08:00 | Williams & Mansell: Red 5Sky Original documentary charting the rise of Nigel Mansell, the Williams F1 racing team and how they came together to fight for the Formula 1 Worl... | 1h 45m | ||
| 09:45 | Luca: Seeing RedChris Harris heads to Italy for exclusive time with Ferrari legend Luca Montezemolo, exploring the passion, heritage and stories behind one of moto... | 2h | ||
| 11:45 | My Icon: Denise LewisIn the next episode of this special series, British heptathlete and Olympic gold medallist Denise Lewis speaks about the figures who have been an i... | 15m | ||
| 12:00 | Discovering: Robin WilliamsA look at the life of the late Robin Williams, the Academy Award-winning star of much-loved films such as Good Will Hunting, Jumanji and Mrs Doubtf... | 1h | ||
| 13:00 | Dolly Parton: America ReunitedFollowing her passing, celebrate the life and legacy of Dolly Parton. With more than 100 million records sold, she became a country music legend an... | 1h | ||
| 14:00 | Discovering: David BowieLeading music critics and DJs discuss the life, music, legacy and larger-than-life stage characters of the glam rock legend. | 1h | ||
| 15:00 | SpitfireThe story of the iconic plane that became a symbol of wartime resilience, told in the words of some of the last-surviving World War II veterans. Ch... | 2h | ||
| 17:00 | The Assassination Of John LennonAn exploration of the life and career of the Beatles superstar, with a look at the strange parallels between him and his killer Mark David Chapman. | 1h 50m | ||
| 18:50 | My Icon: Natasha JonasIn the next episode of this special series, Britain's first female Olympic boxer Natasha Jonas discusses the individuals that have inspired her dur... | 10m | ||
| 19:00 | I Am Richard PryorFilm reflecting on the highs and lows of the Emmy-winning comedian and actor's life. Featuring in-depth interviews with Mike Epps, Tiffany Haddish ... | 1h 50m | ||
| 20:50 | Escobar By EscobarPart one of the true story of Colombian drug lord Pablo Escobar through the eyes of his son, Juan Pablo, whose life changed astronomically the day ... | S1 E1, The Hunt | 1h | |
| 21:50 | Escobar By EscobarPart two of the true story of Colombian drug lord Pablo Escobar through the eyes of his son, Juan Pablo, whose life changed astronomically the day ... | S1 E2, Survival | 1h | |
| 22:50 | Escobar By EscobarThe true story of Colombian drug lord Pablo Escobar through the eyes of his son, Juan Pablo, whose life changed astronomically the day his father d... | S1 E3, Treason | 1h | |
| 23:50 | Escobar By EscobarThe true story of Colombian drug lord Pablo Escobar through the eyes of his son, Juan Pablo, whose life changed astronomically the day his father d... | S1 E4, The Curse | 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_b77v4fw1/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_b77v4fw1/now" # any past day (Archive plan) curl -H "Authorization: Bearer $TVG_KEY" \ "https://api.tvguideapi.com/v1/channels/ch_b77v4fw1/history?from=2025-10-12T00:00:00Z&to=2025-10-13T00:00:00Z"
$ch = curl_init("https://api.tvguideapi.com/v1/channels/ch_b77v4fw1/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_b77v4fw1/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_b77v4fw1/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_b77v4fw1/schedule?date=2026-10-10, the first programme { "data": [ { "id": "ls_masjg34f", "channel": "ch_b77v4fw1", "start": "2026-10-09T22:50:00Z", "stop": "2026-10-10T00:50:00Z", "title": "Lennox Lewis: The Untold Story", "sub_title": null, "description": "The incredible story of Lennox Lewis, who rose from humble beginnings in Lond...", "category": [], "flags": { "new": false, "live": false } } ], "meta": { "count": 21, "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.
A free key in a minute, with Google. No card. Yesterday and today on every channel in 155 countries.