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.
All times UTC. The same day from the API: GET /v1/channels/ch_p4dw2z6r/schedule?date=2026-10-11&tz=UTC
| Time | Programme | Episode | Category | Length |
|---|---|---|---|---|
| 01:05 | Def JamDef Jam: Pop After Dark | Pop After Dark | 1h 1m | |
| 02:06 | Def JamDef Jam: R&B After Dark Vol.1 | R&B After Dark Vol.1 | 1h | |
| 03:06 | Def JamRe-live the iconic 80's era of Def Jam | The Beginning: 80's Era Vol.2 | 1h 1m | |
| 04:07 | Def JamJeezy's greatest hits and timeless trap anthems. | Vol.1 | 1h 3m | |
| 05:10 | Def JamDef Jam's throwback tunes | Throwback | 1h 2m | |
| 06:12 | Def JamDef Jam Latin | Latin | 1h 1m | |
| 07:13 | Hip Hop Vaults Vol.2Listen to Def Jam's Hip Hope tunes straight from the vaults. | 1h 1m | ||
| 08:14 | Hip Hop Vaults Vol.3Listen to Def Jam's Hip Hope tunes straight from the vaults. | 1h 1m | ||
| 09:14 | Def JamThe Golden Era: A History of Def Jam: 90's Vol.5 | 90's Vol.5 | 59m | |
| 10:14 | Def JamThe Bling Era: 00's Hip Hop: A History of Def Jam | Vol.4 | 58m | |
| 11:12 | Def JamThe Women of Def Jam | Vol.1 | 1h | |
| 12:12 | R&B Slow Jams Vol.1R&B Slow Jams | 1h | ||
| 13:12 | Def JamThe definitive collection of LL Cool J's most iconic tracks, celebrating the legacy of a hip-hop pioneer. | Vol.2 | 1h 2m | |
| 14:14 | Def JamThe signature sound of Mariah Carey through her most iconic hits and R&B ballads. | Vol.2 | 31m | |
| 14:45 | Def JamJeezy's greatest hits and timeless trap anthems. | Vol.2 | 1h | |
| 15:45 | Def JamThe essential Big Sean collection, featuring his standout tracks and unmistakable sound. | Vol.1 | 1h 2m | |
| 16:47 | Beastie Boys: Origins Vol.1Discover the early Beastie Boys and the Def Jam artists who defined their era. | 1h 2m | ||
| 17:49 | Def JamFrom breakout singles to fan-favourites, discover the best of Alessia Cara. | Vol.1 | 1h | |
| 18:48 | Def JamDef Jam Original Cuts | Original Cuts | 59m | |
| 19:48 | Def JamDef Jam Pioneers Vol.3 | Pioneers Vol.3 | 1h 2m | |
| 21:50 | Def JamThe best of Fabolous, from timeless classics to his modern tracks. | Vol.2 | 1h 3m | |
| 22:53 | Next Wave: R&B Reimagined Vol.1Chase Shakur, Coco Jones, LAVI$H and more. Discover the next wave of R&B and its leading artists. | 1h | ||
| 23:53 | DJ NextGen: Hip Hop's New Era Vol.2Discover Hip Hop's new era with standout tracks from Wale, Armani White, 2 Chainz and more. | 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_p4dw2z6r/schedule?date=2026-10-11&tz=UTC" # what is on now, and next curl -H "Authorization: Bearer $TVG_KEY" \ "https://api.tvguideapi.com/v1/channels/ch_p4dw2z6r/now" # any past day (Archive plan) curl -H "Authorization: Bearer $TVG_KEY" \ "https://api.tvguideapi.com/v1/channels/ch_p4dw2z6r/history?from=2026-10-06T00:00:00Z&to=2026-10-07T00:00:00Z"
$ch = curl_init("https://api.tvguideapi.com/v1/channels/ch_p4dw2z6r/schedule?date=2026-10-11&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_p4dw2z6r/schedule?date=2026-10-11&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_p4dw2z6r/schedule", params={"date": "2026-10-11", "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_p4dw2z6r/schedule?date=2026-10-11, the first programme { "data": [ { "id": "ls_dk08dhjb", "channel": "ch_p4dw2z6r", "start": "2026-10-11T01:05:25Z", "stop": "2026-10-11T02:06:53Z", "title": "Def Jam", "sub_title": "Pop After Dark", "description": "Def Jam: Pop After Dark", "category": [], "flags": { "new": false, "live": false } } ], "meta": { "count": 23, "date": "2026-10-11", "tz": "UTC" } }
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.