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

Browse the guide, free

TV guide by countryEvery channel listed148 Channel directoryLogos, owners, launch years31,566 Where to watchLive sport and its channels160,503 Shows and episodesEpisode guides back to 190890,418

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

74.6M 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 dayFree key Now and nextEvery channel, this minuteFree key 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.

Run it freeAll 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
Times corrected on 15 feeds7 OctEpisode numbers on listings6 OctChannel facts6 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

TV guide Iraq

On now in Iraq.

Every channel we list in Iraq, with the programme on now and the one after it. Times are Asia/Baghdad.

39channels
02:12local time
Now and nextIraq right now

The first 120 channels in name order. The full list, with every channel's day, is one API call: GET /v1/countries/IQ/now.

ChannelNowOn forNextStarts
Afaq TVNews LiveInside Story02:30
Al Ayyam TVImam Nafea ReadingFiqh02:35
Al Eshraq TVScience Of StupidAli Kelay02:30
Al Fallujah TVNews LiveInside Story02:30
Al Rasheed TVSports ShowPlay Fields' Studio03:00
Al Salam TVScience Of StupidAli Kelay02:30
Al SharqiyaOff airبرنامج04:00
Al Sharqiya NewsThe Chair GameThe Third Half03:00
Al-Naeem TVScience Of StupidAli Kelay02:30
Alahad TVScience Of StupidAli Kelay02:30
Alghadeer TVNews LiveInside Story02:30
Alshaaer TVScience Of StupidAli Kelay02:30
Alsumariaاربعبرنامج عشرين03:00
Altaleaa TVScience Of StupidAli Kelay02:30
Amozhgary TVScience Of StupidAli Kelay02:30
Anwar TV2TV ProgramNews Hour08:00
Bangawaz TVScience Of StupidAli Kelay02:30
Dijlah TVبرنامجبرنامج03:00
Dijlah ZamanRaafat Al HagganA Man And Two Women03:00
Gali KurdistanNews LiveInside Story02:30
Imam Hussein TV 2Science Of StupidAli Kelay02:30
Iraq 24Iran InternationalIran International03:00
Iraq NowIran InternationalIran International03:00
Karbala TVIran InternationalIran International03:00
Kirkuk TVNews LiveInside Story02:30
Kurdistan TVIran InternationalIran International03:00
KurdsatIran InternationalIran International03:00
Kurdsat NewsNews LiveInside Story02:30
Manu ChatScience Of StupidAli Kelay02:30
MBC IraqMagic EyeMy Aunt's Return02:45
NRT 2No scheduled events3x3 Basketball - Final - Asian Games Aichi-Nagoya 2026 M04:00
Payam TVNews LiveInside Story02:30
Rudaw TVIran InternationalIran International03:00
Turkmeneli TVScience Of StupidAli Kelay02:30
ChannelsEvery channel in Iraq
Afaq TVAl-EtejahAl-Naeem TVAlahad TVAl Ayyam TVAl Eshraq TVAl Fallujah TVAlghadeer TVAl IraqiaAl Rasheed TVAl Salam TVAlshaaer TVAl SharqiyaAl Sharqiya NewsAlsumariaAltaleaa TVAmozhgary TVAnwar TV2Bangawaz TVDijlah TVDijlah ZamanGali KurdistanImam Hussein TV 2Iraq 24Iraq NowKarbala TVKirkuk TVKurdistan 24Kurdistan TVKurdsatKurdsat NewsManu ChatMBC IraqNRT 2NRT 4Payam TVRudaw TVSalahalddin TVTurkmeneli TV
The same data, in one API call
Read the docsGet a free key