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

Football on TV

Football on TV, live first.

Every event in the guides of every country over the next two days, with the channels showing it. Times are America/Mexico_City.

5events
178countries
All sportFootballCricketBasketballRugbyTennisMotor racing
Kick-offEventCompetitionLive onChannels
14:00
2026-11-02		RCD Mallorca v Cádiz CFLALIGA HYPERMOTION (T26/27)1CZ - NOVA SPORT 3 (CZ), Nova Sport 3 HD (CZ), ES - GOL (ES), ES - LaLiga SmartbankTV (ES) and 5 more
16:30
2026-11-02		Real Oviedo v UD las PalmasResúmenes LALIGA HyperMotion (T26/27)1ES - GOL (ES), ES - LaLiga SmartbankTV (ES), LALIGA TV HYPERMOTION (ES), Canal Sky Sports 1 (México) (MX) and 3 more
15:30
2026-11-03		Racing Club v Real MadridResúmenes LALIGA EA Sports (T26/27)1ES - M+ LaLigaTV (ES), Canal Sky Sports 16 (MX), Canal Sky Sports 24 (MX), MX - Sky Sports 16 (MX) and 5 more
12:00
2026-11-04		Racing Club v Real MadridResúmenes LALIGA EA Sports (T26/27)1ES - GOL (ES), ES - M+ LaLigaTV (ES), Canal Sky Sports 16 (MX), MX - Sky Sports 16 (MX) and 3 more
15:00
2026-11-04		Liga Mayor de Fútbol Americano v ONEFA 2026Football0AZTECA DEPORTES (MX)

Football on TV: every match and the channels showing it

Domestic leagues, European club competitions, internationals and cup ties, wherever a TV guide lists them, with each channel in each country and whether it shows the match live. Kick-off times are joined to the fixture lists, so a match moved for television shows its broadcast time.

The API answers "where is this match on TV" for any country: GET /v1/events?sport=football&country=GB, or a whole competition with GET /v1/leagues/{id}/events.

All sportEvents dataFor venuesLeagues endpoint

Who uses it

Pubs and sports barsThis weekend's live football on the channels you carry.
Club and fan appsEvery broadcaster for a club's fixtures, country by country.
Fantasy and bettingThe TV channel beside every fixture.
Football mediaAlways-current "football on TV" pages.

Questions

Which football competitions are included?

Every competition that appears in the TV listings, from the Premier League and Champions League to lower leagues and women's football.

Is the kick-off time the TV time or the match time?

Both are kept: the programme's start in the guide and the fixture's kick-off where we hold it.

Why is a match missing?

A match that no guide lists, such as one under a broadcast blackout, has no channel to show. It appears as soon as a guide carries it.

Can I get one team only?

Yes, filter the events by team name in the API.

Where to watch, in one API call
Read the docsGet a free key