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 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_vk1df1df/schedule?date=2026-10-19&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 | 荒野求生500天(普) | 2h | ||
| 21:00 | 農夫與他的田(213)(普) | 1h | ||
| 22:00 | 飛行科技探索:北美防空司令部(普) | 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_vk1df1df/schedule?date=2026-10-19&tz=Asia/Taipei" # what is on now, and next curl -H "Authorization: Bearer $TVG_KEY" \ "https://api.tvguideapi.com/v1/channels/ch_vk1df1df/now" # any past day (Archive plan) curl -H "Authorization: Bearer $TVG_KEY" \ "https://api.tvguideapi.com/v1/channels/ch_vk1df1df/history?from=2025-10-13T00:00:00Z&to=2025-10-14T00:00:00Z"
$ch = curl_init("https://api.tvguideapi.com/v1/channels/ch_vk1df1df/schedule?date=2026-10-19&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_vk1df1df/schedule?date=2026-10-19&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_vk1df1df/schedule", params={"date": "2026-10-19", "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_vk1df1df/schedule?date=2026-10-19, the first programme { "data": [ { "id": "ls_fmmfq4be", "channel": "ch_vk1df1df", "start": "2026-10-18T16:00:00Z", "stop": "2026-10-18T17:00:00Z", "title": "拉丁美洲:安地斯山脈(普)", "sub_title": null, "description": null, "category": [], "flags": { "new": false, "live": false } } ], "meta": { "count": 30, "date": "2026-10-19", "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 150 countries.