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

Last 30 days

API uptimefrom the monitorIncidentsfrom the monitor
All systems

Working normally

Checked every minute from outside our own servers.

TV guide data API

Every channel in 174 countries, in one call

Listings, now and next, channels, shows and the sport on air, under one key, one shape and one set of ids. Start free, with real data, no card.

107Mlistings held
31,720channels
9 minsince the last update
The guide people seeThe answer your app gets
Channel
19:0019:3020:0020:3021:0021:30
GEThttps://api.tvguideapi.com/v1/now?country=gb,de,fr,jp200 OK, 6 channels
Live sport, every country Live or repeat? Know before kick-off.

Every match on air, every channel showing it, and live told apart from repeats, so a bar, a hotel or an app always puts the right game on the right screen.

See tonight's live sportSee the plansBars, pubs, hotels and sports apps
1 keyfor all six kinds of data
one header, every endpoint
0free calls a day
real data, no card
0countries with guides
every one with listings
0shows
1908
2026
episode guides back to 1908
0sport events
each joined to its channels
0 rebuildswhen you upgradethe same key just opens more
DataWhat one key opens

Six kinds of data in one shape and one set of ids. Start on the free key with yesterday's real rows; upgrade and the same call reads today and ahead, nothing to rebuild.

Upgrade in place
Your free key becomes a Live key the moment you upgrade

Same key, same calls. Fields that came back empty fill in on the next request, and paid endpoints open at once.

Free key FreeBuild and test on real data
  • 500 calls a day
  • Yesterday's listings
  • Channels
Live Popular startFor live products
  • Every endpoint now
  • Events, live and repeats
  • XMLTV, MCP
ArchiveFor history and research
  • Everything in Live
  • Listings history
  • Episodes from 1908
CompleteFor products built on it
  • Everything in Archive
  • The biggest allowance
  • Five keys
How it worksYour app calls. The guide appears.

Every request is answered from the same live store of listings, in the same shape, whatever the country. Watch the calls come in and the set fill up.

Requestsapi.tvguideapi.com
P100 TVGUIDEAPIWed 07 Oct 19:42
Listings landinglive
1
Call with your key
One header, any country, any of the six kinds of data.
2
Get one shape back
Our own ids, UTC times, the same fields everywhere.
3
Fill any screen
An app, a site, a bar's screens, or an assistant.
Shows and episodes90,478 shows, with episode guides back to 1908

Every show with its seasons, episode numbers, names and first air dates, matched to the listings it appears in, so tonight's programme carries its season and episode.

Episodes by year
90,478shows in the library
1908earliest episode guide
16.3%of shows still running
96.9%with a language set
CoverageEvery country, measured honestly

We publish how full each country's guide is, field by field, so you know exactly what you get before you build on it.

Countries with listings today0
31,720channels in the directory
96.2%channels with a logo
78.1%channels with a website
Fields on today's listings, of all programmes (counted 18:33 UTC)
Description81.2%
Category45.5%
Episode number29.6%
Episode, where one is named37%
Sub-title22.4%
Descriptions today, largest guides
United States93.3%
Russia21.2%
United Kingdom88%
Germany91.7%
France85.9%
Check your country before you build
Every country's fill, channel by channel, in the ledger.
Open the ledger
For agents Ask the guide from Claude or ChatGPT

Our MCP server gives an assistant the whole guide as tools, on your own key and plan. Ask in plain words; it calls the API and answers with real listings.

whats_on_nowlistings_for_dayfind_channelfind_shownext_episodeevents_on_airwhere_to_watchfree_to_viewcoverage_forusage
Assistant with tvguideapiconnected
Ask about anything on TV
LabTools that run on the free key

Open source, MIT, reading only the public API with your own key. Clone one, paste your key once, and it works.

What is on nowFree keyA terminal guide for any country.
PythonReadClone
Where to watchLiveEvery channel showing a match, by country.
PythonReadClone
XMLTV builderFree keyYour own guide file for a media player.
PythonReadClone
py
Python client
pip install tvguideapi
Copy
php
PHP client
composer require tvguideapi/client
Copy
AI
Ask the guide
Plain questions answered from the API
Try it
PricingStart free, upgrade in place

One key from day one. Pick a plan when you need more and the same key opens it at once. Developers and venues each get plans built for them.

For developersFor venues New
MonthlyAnnual 2 months free
Cancel any time, access to the end of the periodAnnual is twelve months for the price of tenYour key follows your plan the moment it changes
TrustChecked every minute, answered before you ask

An independent monitor checks the API, the website and the MCP every minute, and keeps the record. The common questions are answered here; everything else on the support page.

All systems working
Checked every minute from outside our servers
status.json
APIapi.tvguideapi.comWorking
30 days agotoday
Websitetvguideapi.comWorking
30 days agotoday
MCP server/mcpWorking
30 days agotoday
Live listingsfreshnessupdated 9 min ago
30 days agotoday
Is the free key real data?

Yes. Real listings for yesterday, 500 calls a day, reset at midnight UTC. No sandbox and no card. Today, now and next and the days ahead are on Live.

Can I tell live sport from repeats?

Yes, on Live and above. Every sport listing says whether it is live or a repeat, and Events lists every channel showing a match in each country.

Which countries do you cover?

250, each with a guide. The coverage ledger shows how full each country is, field by field, before you build.

Do ids stay the same?

Yes. Every channel, show and programme has our own id that never changes, so what you store today still matches next year.

Can I use it from an AI assistant?

Yes. Add our MCP server in Claude or ChatGPT and sign in; it uses your own key and plan.

What happens when I upgrade?

Your key follows your plan at once. Fields that were empty on the free key fill in on the next call, and paid endpoints open.

Still have a question?
Open a ticket and we answer on the support page.
Ask support
Live eventsEvery live match, every channel, every country

Sport is where TV data earns its keep. We join every fixture to the channels showing it, country by country, and tell live from delayed and repeat, so the right match reaches the right screen and the right audience.

Tonight on air19:42 UTC
Kick-offMatchCountriesShowingReach
Example board; live counts come from the Events endpointGET /v1/events/live
Know what is truly liveLive, delayed and repeat on every sport listing, so no venue shows yesterday's game as tonight's.kind: live, repeat
Reach as a signalHow many channels and countries carry a match: a ready-made measure of how big it is.meta.count, countries
Where to watch, anywhereThe channel for a match in any country, for travellers, apps and hotels./v1/events/{id}/broadcasts
Live right nowEvery match live on TV this minute, with its channels, country by country./v1/events/live
Who builds on itMade for every business that puts TV on a screen

From a single sports bar to apps with millions of users, the same key answers what is on, where, and whether it is live.

Bars and pubs
Tonight's live matches on every screen, and a board for the week.
Live, not repeatsA screen page for the TVsAlerts when a game moves
/v1/events/live?country=gb
Hotels and resorts
An in-room guide for every guest's country, in their own time zone.
Guides in 174 countriesWhere to watch home teamsLogos and channel facts
/v1/now/{country}
Restaurants
Know the big nights ahead and staff and stock for them.
Fixtures by reachWeek plannerLive sport by country
/v1/events?from=today
Betting and odds
Broadcast reach as a signal of how big a match is, before the markets move.
Reach per eventLive kick-off timesLive told apart from repeats
/v1/events/{id}/broadcasts
Fantasy and prediction
Show users where to watch the games they picked, in their country.
Where to watchOur stable idsMCP for assistants
/v1/watch/{event}
Media and publishers
TV listings pages, "what is on tonight" and episode guides that keep themselves current.
Listings and showsEpisodes from 1908XMLTV exports
/v1/listings/{country}/{day}
Smart TV and set-top apps
A full electronic guide without running a single feed yourself.
Now and nextLogos for every channelFree to view
/v1/now/{country}
Signage and travel
Screens in airports, gyms and lounges, and travel apps showing what is on where you land.
Every countryLocal timesOne shape everywhere
/v1/now/{country}
Developers get what they need
One key, every endpointOur own ids that never changeUTC times, local daysXMLTV exportsMCP and an agent skillCode in four languagesAn OpenAPI descriptionA real free key
Quick start
Put the right match on the right screen, tonight

Every channel in 174 countries, live told apart from repeats, under one key. Start free in thirty seconds, upgrade the moment you need more.

Get a free keySee every planNo card for the free key