74.3M 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_cdamq4wh/schedule?date=2026-10-15&tz=America/New_York
| Time | Programme | Episode | Category | Length |
|---|---|---|---|---|
| 00:00 | The Ms. Pat ShowPat does a set at a local club but clashes with the Black manager who tells her she's too ghetto for his crowd; Terry struggles to hide a secret. | S1 E6, B****... I'm Funny | Series, Sitcom | 30m |
| 00:30 | The Ms. Pat ShowAfter the lights go out, Pat decides it's time for her and Denise to get jobs; Terry tries to make the best of things by hanging out with the kids. | S1 E7, Lights Out | Series, Sitcom | 30m |
| 01:00 | Tyler Perry's Assisted LivingJeremy's online plumber training backfires on him, literally. | S1 E9, The Monster | Series, Sitcom | 36m |
| 01:36 | Tyler Perry's Assisted LivingSandra tries to mislead Phillip about where she's going and who she is going with. | S1 E10, Dark Chocolate | Series, Sitcom | 36m |
| 02:12 | Tyler Perry's Assisted LivingLeah and Jeremy learn that Phillip and Sandra have left the facility without their knowledge or permission. | S1 E11, A Lamb To Slaughter | Series, Sitcom | 36m |
| 02:48 | Tyler Perry's Assisted LivingLeah confides in Cora regarding Sandra's most recent behavior; Sandra confronts Philip about snitching to their parents. | S1 E12, Hard Decisions | Series, Sitcom | 36m |
| 03:24 | Tyler Perry's Assisted LivingLeah learns that Mr. Brown has cut down Vinny's plants in the backyard. | S1 E13, Mary Jane | Series, Sitcom | 36m |
| 04:00 | ReminisceReminiscing with this mix of throwback R&B and Hip Hop jams to start the morning; curated for her. | Music | 1h | |
| 05:00 | ReminisceReminiscing with this mix of throwback R&B and Hip Hop jams to start the morning; curated for her. | Music | 1h | |
| 06:00 | ReminisceReminiscing with this mix of throwback R&B and Hip Hop jams to start the morning; curated for her. | Music | 1h | |
| 07:00 | ReminisceReminiscing with this mix of throwback R&B and Hip Hop jams to start the morning; curated for her. | Music | 1h | |
| 08:00 | ReminisceReminiscing with this mix of throwback R&B and Hip Hop jams to start the morning; curated for her. | Music | 1h | |
| 09:00 | ReminisceReminiscing with this mix of throwback R&B and Hip Hop jams to start the morning; curated for her. | Music | 1h | |
| 10:00 | ReminisceReminiscing with this mix of throwback R&B and Hip Hop jams to start the morning; curated for her. | Music | 1h | |
| 11:00 | Tyler Perry's House of PayneCalvin feels some type of way when Miranda gets swept off her feet, causing him to make an epic mistake; a chain letter changes C.J. and Ella's for... | S12 E14, Say My Name | Series, Sitcom | 36m |
| 11:36 | Tyler Perry's House of PayneThe unfortunate news about a young firefighter forces C.J. to have a transparent conversation with Malik and Jazmine; Miranda discovers she's missi... | S12 E15, Out In the Open | Series, Sitcom | 36m |
| 12:12 | Tyler Perry's House of PayneJazmine becomes a social media influencer and considers leaving college; CJ accidentally steals her thunder, revealing the fickle nature of interne... | S12 E16, Zaddy | Series, Sitcom | 36m |
| 12:48 | Tyler Perry's House of PayneCurtis becomes the neighborhood watch Captain and the power goes to his head, much to the demise of the family; Jazmine tries to convince CJ and Ma... | S12 E17, El Capitan | Series, Sitcom | 36m |
| 13:24 | Tyler Perry's House of PayneCalvin and Laura debate the merits of traditional aspects of marriage versus creating new traditions; Ella presents them with the broom she and Cur... | S12 E18, To Jump or Not To Jump | Series, Sitcom | 36m |
| 14:00 | Dance for MeOpposite worlds collide when seductive exotic dancer, Isis Shaw, falls in love with up-and-coming politician Osiris Hughes. However, their love is ... | Movie, Thriller | 2h 30m | |
| 16:30 | Tyler Perry's Meet the BrownsWill reacts badly when he learns that Sasha's mammogram shows she has a lump. | S3 E15, Meet the Wills | Series, Sitcom | 35m |
| 17:05 | Tyler Perry's Meet the BrownsA troubled boy brings a gun to Cora's class after repeated bullying. | S3 E17, Meet the Bully | Series, Sitcom | 35m |
| 17:40 | Tyler Perry's Meet the BrownsWill secretly takes dancing lessons so he can take Sasha to a party; the Colonel and Edna decide to move out of Brown Meadows. | S3 E1, Meet the Two Left Feet | Series, Sitcom | 35m |
| 18:15 | Tyler Perry's Meet the BrownsSasha and Will fight over Brianna's news; Cora joins a spin class to be close to the new principal. | S3 E2, Meet the Lessons | Series, Sitcom | 35m |
| 18:50 | Tyler Perry's Meet the BrownsOne of the frat boys attacks Simone at a party; Brown decides to fire Jesus to save money. | S3 E3, Meet the Disorderly | Series, Sitcom | 35m |
| 19:25 | Tyler Perry's Meet the BrownsWill's mother, Vera, shows up; Sasha doesn't belive in Vera's Southern remedies; Daisy goes missing. | S3 E4, Meet the Mom | Series, Sitcom | 35m |
| 20:00 | Dance for MeOpposite worlds collide when seductive exotic dancer, Isis Shaw, falls in love with up-and-coming politician Osiris Hughes. However, their love is ... | Movie, Thriller | 2h 30m | |
| 22:30 | Ms. Pat Settles ItA neighbor demanding payback for trash duty and lawn care; an ex is accused of ditching a birthday bash over parking drama; a son dragging his mone... | S3 E4, Garbage, Grudges, And Grown-Up Rent | Series, Reality | 30m |
| 23:00 | Ms. Pat Settles ItSettling three cases, from a twerk that broke a Vegas mirror to siblings fighting over strip club debts, and a man demanding payback after his ex-b... | S3 E5, Siblings, Strip Clubs, & Stacks | Series, Reality | 30m |
| 23:30 | Ms. Pat Settles ItMs. Pat settles three cases: a Botox-happy mom who spent her daughter's dog funds on her face, a sister who loses her job when her sibling quits to... | S3 E6, Botox, Backstabs, & Busted Friendships | Series, Reality | 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_cdamq4wh/schedule?date=2026-10-15&tz=America/New_York" # what is on now, and next curl -H "Authorization: Bearer $TVG_KEY" \ "https://api.tvguideapi.com/v1/channels/ch_cdamq4wh/now" # any past day (Archive plan) curl -H "Authorization: Bearer $TVG_KEY" \ "https://api.tvguideapi.com/v1/channels/ch_cdamq4wh/history?from=2025-10-13T00:00:00Z&to=2025-10-14T00:00:00Z"
$ch = curl_init("https://api.tvguideapi.com/v1/channels/ch_cdamq4wh/schedule?date=2026-10-15&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_cdamq4wh/schedule?date=2026-10-15&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_cdamq4wh/schedule", params={"date": "2026-10-15", "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_cdamq4wh/schedule?date=2026-10-15, the first programme { "data": [ { "id": "ls_b8q8p2cq", "channel": "ch_cdamq4wh", "start": "2026-10-15T04:00:00Z", "stop": "2026-10-15T04:30:00Z", "title": "The Ms. Pat Show", "sub_title": "B... I'm Funny", "description": "Pat does a set at a local club but clashes with the Black manager who tells h...", "category": [ "series", "sitcom" ], "flags": { "new": false, "live": false } } ], "meta": { "count": 30, "date": "2026-10-15", "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 | 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.