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_a2mxf3rg/schedule?date=2026-10-12&tz=America/New_York
| Time | Programme | Episode | Category | Length |
|---|---|---|---|---|
| 23:53 | Ruyi's Royal Love in the PalaceThe Han Tribe offers a beauty to the Emperor as a gesture of goodwill, but entering the palace may not be every woman's dream. | 58m | ||
| 00:51 | Borrowed TimeUrged by her mother, Ting sets out from Guangzhou to Hong Kong to look for her father who has been absent for 20 years. | 1h 55m | ||
| 02:46 | Boiling PotNoelle joins Jennie Chang to have a Cantonese style seafood feast at the 30-year-old restaurant 888 Seafood. | 14m | ||
| 03:00 | Lost GirlA young ballet dancer flees her home, finding refuge with San, a street orphan. An unexpected accident changes everything. Fueled by a desire to un... | 2h 4m | ||
| 05:04 | The Glory of Global ChineseExploring the profound impact of AI on the global film industry - how it reshapes production, fuels creativity, and transforms audience engagement. | 30m | ||
| 05:33 | The Heir to the ThroneA security guard at Ko Tsun’s apartment block mentions he saw Chi-lam arguing with Ho-yee that day when Chi-lam got into trouble. | 50m | ||
| 06:24 | The Heir to the ThroneChi-lam’s silk scarf is floating beside a yacht. Chi-bun promptly torches it. | 50m | ||
| 07:13 | All Out of LoveStep-siblings navigate a life of hardships and lost loves. | 55m | ||
| 08:08 | All Out of LoveStep-siblings navigate a life of hardships and lost loves. | 56m | ||
| 09:04 | The Depths of WumengMa Qin Hao leaves the hustle and bustle of the city to return to his home village. | 56m | ||
| 10:00 | The Depths of WumengQin Hao runs into his former girlfriend Gun Yue Liang. | 56m | ||
| 10:55 | Nothing Gold Can StayDu Mingli learns Zhou Ying will open up a factory. He asks Zhao Baishi to kill her to avoid rivalry. | 58m | ||
| 11:54 | Nothing Gold Can StayAt the deathbed of Wu Weiwu, Zhou promises Wu Ze's safety. Du blackmails Shen for his reformist son. | 59m | ||
| 12:53 | Lost GirlA young ballet dancer flees her home, finding refuge with San, a street orphan. An unexpected accident changes everything. Fueled by a desire to un... | 2h 6m | ||
| 15:00 | The Heir to the ThroneA security guard at Ko Tsun’s apartment block mentions he saw Chi-lam arguing with Ho-yee that day when Chi-lam got into trouble. | 50m | ||
| 15:50 | The Heir to the ThroneChi-lam’s silk scarf is floating beside a yacht. Chi-bun promptly torches it. | 50m | ||
| 16:40 | All Out of LoveStep-siblings navigate a life of hardships and lost loves. | 55m | ||
| 17:34 | All Out of LoveStep-siblings navigate a life of hardships and lost loves. | 56m | ||
| 18:30 | Lost Girl On nowA young ballet dancer flees her home, finding refuge with San, a street orphan. An unexpected accident changes everything. Fueled by a desire to un... | 2h 4m | ||
| 20:35 | The Glory of Global ChineseExploring the profound impact of AI on the global film industry - how it reshapes production, fuels creativity, and transforms audience engagement. | 30m | ||
| 21:04 | The Depths of WumengMa Qin Hao leaves the hustle and bustle of the city to return to his home village. | 56m | ||
| 22:00 | The Depths of WumengQin Hao runs into his former girlfriend Gun Yue Liang. | 56m | ||
| 22:55 | Nothing Gold Can StayDu Mingli learns Zhou Ying will open up a factory. He asks Zhao Baishi to kill her to avoid rivalry. | 58m | ||
| 23:54 | Nothing Gold Can StayAt the deathbed of Wu Weiwu, Zhou promises Wu Ze's safety. Du blackmails Shen for his reformist son. | 59m |
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_a2mxf3rg/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_a2mxf3rg/now" # any past day (Archive plan) curl -H "Authorization: Bearer $TVG_KEY" \ "https://api.tvguideapi.com/v1/channels/ch_a2mxf3rg/history?from=2025-10-12T00:00:00Z&to=2025-10-13T00:00:00Z"
$ch = curl_init("https://api.tvguideapi.com/v1/channels/ch_a2mxf3rg/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_a2mxf3rg/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_a2mxf3rg/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_a2mxf3rg/schedule?date=2026-10-12, the first programme { "data": [ { "id": "ls_ngna5ds1", "channel": "ch_a2mxf3rg", "start": "2026-10-12T03:53:44Z", "stop": "2026-10-12T04:51:16Z", "title": "Ruyi's Royal Love in the Palace", "sub_title": null, "description": "The Han Tribe offers a beauty to the Emperor as a gesture of goodwill, but en...", "category": [], "flags": { "new": false, "live": false } } ], "meta": { "count": 24, "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 | 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.