Free key: real listings for yesterday, 500 calls a day, no card174 countriesGet yours in 30 seconds
tvguideapi
Sign inGet a free key

Browse the guide, free

TV guide by countryEvery channel listed174 Channel dataLogos, owners, launch years31,782 Where to watchLive sport and its channels245,174 Shows and episodesEpisode guides back to 190890,534

How deep it goes

HistoryListings from 2023, episodes from 1908 FreshnessWithin a second of a change Fill by countryTitles, descriptions, episodes Coverage ledgerWhat we hold, country by country

Popular guides

United KingdomFreeview, Sky and BBC regions United StatesNetworks and local stations GermanyPublic and Sky channels South KoreaCable and satellite, from 2023
In one call

133.5M listings

Every country's schedule under one key, one shape and one set of ids.

Get a free keySee coverage

Schedules

ListingsBy channel, country and day; yesterday on the free keyFree key Now and nextEvery channel, this minuteLive ArchivePast schedules, day by dayPaid

Things on air

ChannelsRegistry, logos, factsFree key Shows and episodesSeasons, numbers, air datesPaid EventsFixtures and every channelPaid Free to viewFree-to-air per countryNew

Ways in

REST APIJSON on api.tvguideapi.com MCP serverFrom Claude or ChatGPT Bulk exportsXMLTV per country or channelPaid Agent skillTeach any agent the API
Try it now

GET /v1/now

What every channel in a country is showing this minute, with the next programme after it. On the Live plan; the free key reads yesterday.

See LiveAll endpoints

Start here

Quick startFirst call in two minutes AuthenticationYour key, headers, rotating Plans and limitsQuotas, rate limits, headers Errors and paginationCodes, cursors, pages SupportFAQ and tickets

Reference

API referenceEvery endpoint with Try it Countries and channelsIds and how to find them Times and time zonesLocal days, UTC timestamps Events guideFixtures to channels

For agents and tools

MCP serverSet up and the tool list Agent skillOne file that teaches an agent OpenAPIDownload the full spec ManualThe whole API as one file
Changelog
Free key trial ends: yesterday only20 OctWebhooks18 OctChange feed18 Oct
Quick startSearch docs

Tools you can run

What is on nowA terminal guide for any country Where to watchEvery channel showing a match XMLTV builderA guide file for a media player

Clients

Python clientpip install, every endpoint PHP clientComposer or one file Ask the guidePlain questions answeredNew

Ideas built on it

Bar and pub screensTonight's sport, by venue Watchlist alertsWhen a show is next on Travel TVWhat is on where you are going
Open source

MIT, no lock-in

Every lab tool reads only the public API with your own key, so it runs on the free key.

Open the labGitHub

Right now

APIapi.tvguideapi.comWorking Websitetvguideapi.comWorking MCP server/mcpWorking

Last 30 days

API uptimefrom the monitorIncidentsfrom the monitor

Keep informed

Incident historyEvery incident and its fix status.jsonFor your own monitoring
All systems

Working normally

Checked every minute from outside our own servers.

Open statusstatus.json

What is on now

What is on now.

A country's channels this minute, from the same call your app would make.

ChannelNowOn forNextStarts
2900 Happiness2900 Happiness Episode 332900 Happiness22:17
7th Heaven7th Heaven Red Tape7th Heaven22:08
Are You The One?Are You The One?: On to the NextAre You The One?: All or Nothing22:24
ATG LiveV64 Live8 Rätt22:30
Auction HuntersAuction Hunters: Mr. Haff Goes to Washington Mr. Haff Goes to WashingtonAuction Hunters: Home on the Gun Range22:27
AvatarAvatar: The Last Airbender: The Avatar and The FirelordAvatar: The Last Airbender: The Runaway22:26
AwkwardAwkward: Girls Gone Viral Girls Gone ViralAwkward: Misadventures in Babysitting22:23
Axess TVOppenheimers börda - En djupdykning i Dr. J. Robert Oppenheimers briljanta och komplexa sinneRevolutionsåret 197923:00
Beavis and Butt-HeadBeavis and Butt-Head: Meet GodBeavis and Butt-Head: 1-900-BEAVIS / Water Safety22:16
BeckerBeckerBecker22:08
Best of MTVMy Super Sweet 16 BjornPimp My Ride: 1967 Ford Mustang22:30
Best of Paradise Hotel: FinalveckanParadise Hotel, säsong 8Paradise Hotel, säsong 822:31
Best of Paradise Hotel: Kyssar & karlekParadise Hotel, säsong 16Paradise Hotel, säsong 1722:32
Best of Paradise Hotel: Pandoras AskParadise Hotel, säsong 5Paradise Hotel, säsong 522:49
Best of Paradise Hotel: SkolveckanParadise Hotel, säsong 8Paradise Hotel, säsong 822:35
Best of The Drew Barrymore ShowThe Drew Barrymore Show: Stephanie Izard, Eve Rodsky, Drew's NewsThe Drew Barrymore Show: Melissa Rivers, Law Roach, Christian Siriano22:11
BETGames People Play: A Wing and A Prayer A Wing and a PrayerGames People Play: The Bitch is Back22:37
BoligjaktenBoligjakten: Episode 1001 Episode 1Boligjakten: Episode 100222:57
Boligkjop i blindeBoligkjøp i blinde Danmark: Episode 503Boligkjøp i blinde Danmark: Episode 50422:45
Boligkob i blindeBoligkøb i blinde: Episode 406Boligkøb i blinde: Episode 50122:58
Bondi RescueBondi Rescue LiveBondi Rescue22:30
Britain's Next Top ModelBritain's Next Top Model Week 1 MainBritain's Next Top Model23:00
Broad CityBroad City: Just the Tips Just the TipsBroad City: Mushrooms22:23
Brondby TVDokumentarLegenden fortæller00:14
BullBull Jury DutyBull22:59
Buying Blind DenmarkHusköp i blindo Danmark: Avsnitt 602Husköp i blindo Danmark: Avsnitt 60322:52
Camp KulinarisCamp Kulinaris: Episode 627 Episode 27Camp Kulinaris: Episode 62822:59
Car ChaseCar Chase LiveCar Chase23:00
Caroline in the CityCaroline in the City Caroline and the Big Bad BedCaroline in the City22:25
Chappelle's ShowChappelle's Show: Piss on You & The World's Greatest WarsChappelle's Show: Make-A-Wish & Fisticuff22:15
CharterfeberCharterfeber Jeg veit ikke hvilket merke det er, men de er ålreiteCharterfeber22:47
CheersCheersCheers22:28
Comedy Central RoastThe Roast of Justin BieberThe Roast of Rob Lowe23:11
Crazy Ex-GirlfriendCrazy Ex-Girlfriend Nathaniel Is IrrelevantCrazy Ex-Girlfriend22:21
CSICSI: Crime Scene Investigation: Crate 'n Burial Crate 'n BurialCSI: Crime Scene Investigation: Cool Change22:53
Dallas Cowboys CheerleadersDallas Cowboys Cheerleaders: Making the TeamDallas Cowboys Cheerleaders: Making the Team: Kunngjøring av laget22:54
Dating Naked UKDating Naked UK: Dare or Bare Dare or Bare Dating Naked UK: Cocktails & Cock Tales22:55
Den gule sofa med Allan SindbergDen gule sofa med Allan SindbergDen gule sofa med Allan Sindberg22:38
Diagnosis MurderDiagnosis Murder A Passion for MurderDiagnosis Murder22:11
Discovery ChannelFångat på polisens kameraAlaska: The Last Frontier23:10

The call behind it: GET /v1/countries/SE/now.

What is on TV now, in any country

Pick a country to see the programme on now and the one after it on its channels, in its own local time. The table is the same answer GET /v1/countries/{cc}/now gives your app.

Refresh it every minute for a live screen, or ask for one channel or a list of channels.

Now and next dataTV guide by countryWatching abroadNow endpoint

Who uses it

Live screensA now-and-next board.
HotelsWhat is on in guests' rooms.
AssistantsAnswer "what is on now".
TestingCheck a country before building.

Questions

Which countries?

Every country we hold.

Local time?

Yes, the country's own.

How many channels?

The table shows the first ones; the API returns them all.

Which plan?

Now and next is on the paid plans.

The same data, in one API call
Read the docsGet a free key