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 Pacific/Auckland 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 Pacific/Auckland. The same day from the API: GET /v1/channels/ch_x4m1jhnh/schedule?date=2026-10-18&tz=Pacific/Auckland
| Time | Programme | Episode | Category | Length |
|---|---|---|---|---|
| 23:40 | QuizSeries Final: Persecuted and hounded by the public and press - Charles, Diana and Tecwen head to court. S1 E3 | Game show | 1h 5m | |
| 00:45 | The Ex-Wife NewDesperate to get her daughter back, Tasha will do anything to get to the truth, even if that means accepting an offer of help from an unlikely sour... | Drama | 50m | |
| 01:35 | Chateau DIY NewThe first bride and groom of the season are due at Belinda and Lee’s, however Lee has broken his foot. Tim and Krys begin major renovations to thei... | Lifestyle | 45m | |
| 02:20 | TVNZ1 QuizTVNZ1 Quiz | Game show/quiz/contest | 1h 10m | |
| 03:30 | InfomercialsInfomercials | Soul / r & b | 30m | |
| 04:00 | InfomercialsInfomercials | Soul / r & b | 30m | |
| 04:30 | InfomercialsInfomercials | Soul / r & b | 30m | |
| 05:00 | InfomercialsInfomercials | Soul / r & b | 30m | |
| 05:30 | InfomercialsInfomercials | Soul / r & b | 30m | |
| 06:00 | Rural Delivery NewMeet the places and faces behind the New Zealand agricultural sector with Rural Delivery. | Science | 30m | |
| 06:30 | Find My Country House: Canada NewCouples looking to relocate from the city find their perfect country house in a regional, Canadian location. | Foothills | Science | 30m |
| 07:00 | Tagata PasifikaTagata Pasifika is TVNZ's flagship Pacific news show, telling the stories of Pacific Islanders and its community. Made with the support of NZ on Air. | Current affairs | 25m | |
| 07:25 | Songs Of PraiseInspiring hymns and songs, together with uplifting stories of faith from around the UK and beyond. | Belfast To Dublin | Culture | 35m |
| 08:00 | James May And The Dull Men NewJames designs a fully integrated desk/workout station. He’s on a mission to use up all the ink in a Bic pen and make spaghetti in a paper shredder. | S1 E5, Deskercise | Science | 1h |
| 09:00 | Q+A With Jack TameHosted by Jack Tame, Q+A brings viewers the important political interviews and discussions of the week, taking a close look at politics, economics,... | Q+A With Jack Tame 2026 33 | Current affairs | 1h 5m |
| 10:05 | Waka HuiaWaka Huia is an iconic archival series recording the unique stories and histories of Māori for all New Zealanders. | Te Whare Tapere O Te Arawa | Culture | 30m |
| 10:35 | MaraeYour way in to the Māori world and the issues that matter. Māiatanga, Whanaungatanga, Manaakitanga - We bring you stories with heart. | Culture | 30m | |
| 11:05 | The Secret Genius Of Modern Life NewHannah Fry discovers the hidden WWII radar technology that heats up baked beans, and learns the legend of the melted candy bar in an engineer’s poc... | S2 E4, Microwave | Science | 1h 25m |
| 12:30 | Find My Country HouseEscape the hustle and bustle of city life with Aussie home buyers looking for a lifestyle change. From quaint farmhouses to luxury mountain estates... | Mildura 1 | Lifestyle | 30m |
| 13:00 | Moving Houses NewGigi and Matt have big plans to replace their drafty Sumner cottage with a stunning relocatable, but Grant must navigate tight streets, trees and p... | Sumner (Bu) | Science | 1h |
| 14:00 | The Great EscapersThe Chasers in Rhodes - The Chase stars Mark Labbett, Jenny Ryan and Shaun Wallace head to the Greek island of Rhodes where they compete to throw t... | The Chase In Rhodes | Science | 1h |
| 15:00 | Celebrity LingoHosted by Adil Ray, Celebrity Lingo sees famous faces pair up and go head-to-head in the fast-paced wordplay game and win big money for their chari... | Celebrity Lingo | Game show | 30m |
| 15:30 | NPC RugbyJoin us for coverage of the second semi final match in the NPC season. Teams to be confirmed. | Semi Final 2 | Sport, Rugby | 2h 30m |
| 18:00 | 1News at SixThe nation's leading team of journalists brings viewers the latest news and sport, plus the most comprehensive weather report. | S2026 E291, Episode 291 | Current affairs | 1h |
| 19:00 | Hyundai Country Calendar NewA Waikato couple grow 100 tonnes of berries a year, keeping it simple by picking the fruit when it’s ripe and selling it fresh at the farm gate. | Berry Cool | Science | 30m |
| 19:30 | Moving Houses NewMartin and Jess have found their dream home, but getting the two-storey house to their farm means battling narrow country roads, wild weather, and ... | Taranaki (Br) | Science | 1h |
| 20:30 | A Remarkable Place To Die NewSeason Finale: Anais is forced into a deadly battle for survival as Sam and Lena prepare to display her for their final masterpiece. Simon desperat... | S2 E6, Eye-witness | Drama | 1h 55m |
| 22:25 | Wild CherryThings fall apart when the school discover some photos. Lorna and Juliet have a showdown. S1 E4 | Drama | 1h 10m | |
| 23:35 | Q+A With Jack TameHosted by Jack Tame, Q+A brings viewers the important political interviews and discussions of the week, taking a close look at politics, economics,... | Q+A With Jack Tame 2026 33 | Current affairs | 55m |
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_x4m1jhnh/schedule?date=2026-10-18&tz=Pacific/Auckland" # what is on now, and next curl -H "Authorization: Bearer $TVG_KEY" \ "https://api.tvguideapi.com/v1/channels/ch_x4m1jhnh/now" # any past day (Archive plan) curl -H "Authorization: Bearer $TVG_KEY" \ "https://api.tvguideapi.com/v1/channels/ch_x4m1jhnh/history?from=2025-10-13T00:00:00Z&to=2025-10-14T00:00:00Z"
$ch = curl_init("https://api.tvguideapi.com/v1/channels/ch_x4m1jhnh/schedule?date=2026-10-18&tz=Pacific/Auckland"); 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_x4m1jhnh/schedule?date=2026-10-18&tz=Pacific/Auckland", { 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_x4m1jhnh/schedule", params={"date": "2026-10-18", "tz": "Pacific/Auckland"}, headers={"Authorization": f"Bearer {os.environ['TVG_KEY']}"}, ) for slot in r.json()["data"]: print(slot["start"], slot["title"])
// GET /v1/channels/ch_x4m1jhnh/schedule?date=2026-10-18, the first programme { "data": [ { "id": "ls_c4rjb5vw", "channel": "ch_x4m1jhnh", "start": "2026-10-17T10:40:00Z", "stop": "2026-10-17T11:45:00Z", "title": "Quiz", "sub_title": null, "description": "Series Final: Persecuted and hounded by the public and press - Charles, Diana...", "category": [ "game show" ], "flags": { "new": false, "live": false } } ], "meta": { "count": 29, "date": "2026-10-18", "tz": "Pacific/Auckland" } }
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.