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 Asia/Taipei 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 Asia/Taipei. The same day from the API: GET /v1/channels/ch_7yq8391y/schedule?date=2026-10-12&tz=Asia/Taipei
| Time | Programme | Episode | Category | Length |
|---|---|---|---|---|
| 00:00 | 拉丁美洲:委內瑞拉【普】 | 1h | ||
| 01:00 | 拉丁美洲:潘塔納爾濕地【普】 | 1h | ||
| 02:00 | 絕美地球 愛爾蘭馬拉莫爾到巴倫高原【普】 | 30m | ||
| 02:30 | 絕美地球 法國翁普斯到多姆山【普】 | 30m | ||
| 03:00 | 絕美地球 德國波茲坦到柏林【普】 | 30m | ||
| 03:30 | 絕美地球 美國美洲野牛到牛仔競技【普】 | 30m | ||
| 04:00 | 海洋奧秘:阿爾文號深潛器【普】 | 30m | ||
| 04:30 | 海洋奧秘:永續漁業關鍵【普】 | 30m | ||
| 05:00 | 布魯克斯逆倫血案【護】 | 1h | ||
| 06:00 | 機械巨獸產地:保時捷休旅車【普】 | 1h | ||
| 07:00 | 全球轉運站:莫斯科地鐵【普】 | 1h | ||
| 08:00 | 拉丁美洲:委內瑞拉【普】 | 1h | ||
| 09:00 | 拉丁美洲:潘塔納爾濕地【普】 | 1h | ||
| 10:00 | 絕美地球 愛爾蘭馬拉莫爾到巴倫高原【普】 | 30m | ||
| 10:30 | 絕美地球 法國翁普斯到多姆山【普】 | 30m | ||
| 11:00 | 絕美地球 德國波茲坦到柏林【普】 | 30m | ||
| 11:30 | 絕美地球 美國美洲野牛到牛仔競技【普】 | 30m | ||
| 12:00 | 海洋奧秘:阿爾文號深潛器【普】 | 30m | ||
| 12:30 | 海洋奧秘:永續漁業關鍵【普】 | 30m | ||
| 13:00 | 布魯克斯逆倫血案【護】 | 1h | ||
| 14:00 | 機械巨獸產地:保時捷休旅車【普】 | 1h | ||
| 15:00 | 全球轉運站:莫斯科地鐵【普】 | 1h | ||
| 16:00 | 野生動物方城市:夏季危機【普】 | 30m | ||
| 16:30 | 野生動物方城市:北極避難所【普】 | 30m | ||
| 17:00 | 野生非洲:維龍加山脈【普】 | 1h | ||
| 18:00 | 崩解的民主政治:當美國不再民主【普】 | 1h | ||
| 19:00 | 崩解的民主政治:全球民主現狀【普】 | 1h | ||
| 20:00 | 崩解的民主政治:未來之路【普】 | 1h | ||
| 21:00 | 農夫與他的田 第203集【普】 | 1h | ||
| 22:00 | 飛行科技探索:B-52戰略轟炸機【普】 | 30m | ||
| 22:30 | 謀殺的十大步驟:傑西馬修、史蒂芬塞爾【護】 | 1h 30m |
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_7yq8391y/schedule?date=2026-10-12&tz=Asia/Taipei" # what is on now, and next curl -H "Authorization: Bearer $TVG_KEY" \ "https://api.tvguideapi.com/v1/channels/ch_7yq8391y/now" # any past day (Archive plan) curl -H "Authorization: Bearer $TVG_KEY" \ "https://api.tvguideapi.com/v1/channels/ch_7yq8391y/history?from=2025-10-13T00:00:00Z&to=2025-10-14T00:00:00Z"
$ch = curl_init("https://api.tvguideapi.com/v1/channels/ch_7yq8391y/schedule?date=2026-10-12&tz=Asia/Taipei"); 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_7yq8391y/schedule?date=2026-10-12&tz=Asia/Taipei", { 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_7yq8391y/schedule", params={"date": "2026-10-12", "tz": "Asia/Taipei"}, headers={"Authorization": f"Bearer {os.environ['TVG_KEY']}"}, ) for slot in r.json()["data"]: print(slot["start"], slot["title"])
// GET /v1/channels/ch_7yq8391y/schedule?date=2026-10-12, the first programme { "data": [ { "id": "ls_f3dgabr9", "channel": "ch_7yq8391y", "start": "2026-10-11T16:00:00Z", "stop": "2026-10-11T17:00:00Z", "title": "拉丁美洲:委內瑞拉【普】", "sub_title": null, "description": null, "category": [], "flags": { "new": false, "live": false } } ], "meta": { "count": 31, "date": "2026-10-12", "tz": "Asia/Taipei" } }
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 155 countries.