Free key: real listings for yesterday, 500 calls a day, no card175 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 Iran

Iran on TV, at a glance.

19 channels with what is on now, the sport worth knowing about this week, and the endpoints that give you every slot. Times are Asia/Tehran.

19channels
19with a schedule today
1 daysahead
2026history from
23:15local time
On now in IranNext starts, +0330
iFilm ArabicSpeed00:30
Sahar KurdiFor Ziko00:30
Press TVFamily Jurisprudence23:15
Asil TVFor Ziko00:30
Al-Kawthar TVFor Ziko00:30
Hispan TVMonoblock23:55
Varzesh TVشب های فوتبالی (زنده)23:55
Tehran TVمجموعه لویانگ - قسمت 3923:21
IRIB Omidرفیق زنده ویژه هفته نوجوان23:18
IRIB Mostanadزندگی به سبک بازماندگان نخستین ( پخش زنده آنلاین)23:40
IRIB 3گزیده سرآشپز - فصل دوم23:48
IRIB 1میان برنامه23:25
SummaryIran in our data

Counted from our own listings every hour. The detail behind each figure is one API call away.

Channels1919 with a schedule today
Registry ids18
Guide only1
With a logo18
Schedule depth1 daysahead, on most of its main channels
Today84%
Tomorrow32%
Day 70%
Field fill100%of today's programmes carry a description
Category21%
Episode no.2%
Series link0%
Sport this week0events on TV in Iran, next 7 days
Live0
Football0
Other sport0
EndpointsThe API for Iran listings

Every call below answers for Iran as shown. The Free key reads yesterday; the plans add today, the days ahead, changes and the archive.

EndpointWhat it returnsPlan
GET /v1/countries/IR/channelsEvery TV channel in one country, ordered the way its own guides list them, with ids, names, logos and categories.Free keyDocs
GET /v1/countries/IR/nowWhat is on now on every TV channel in a country, with what comes next, in one call.Live and aboveDocs
GET /v1/countries/IR/tonightPrime time tonight on every TV channel in a country, from the local hour you choose, in one grid.Live and aboveDocs
GET /v1/countries/IR/coverageHow full the TV data is for a country on a day: the share of programmes with a description, category, episode number and more.Free keyDocs
GET /v1/guideA TV guide grid for up to 50 channels over a window you choose, every slot with its times in UTC, ready to draw.Free keyDocs
GET /v1/channels/{id}/scheduleA TV channel's day slot by slot: start and stop in UTC, title, description, category, and the series and episode where we matched it.Free keyDocs
GET /v1/events?country=IRSports events on TV by sport, league and day, in every country or only those on air where you are.Live and aboveDocs
GET /v1/changes?country=IREvery TV listing that moved, appeared or disappeared since a time you give, to keep your own copy of the guide in step.Live and aboveDocs
GET /v1/channels/{id}/historyPast schedules for a TV channel from the archive, slot by slot over any window of up to 31 days, with the same fields as today.ArchiveDocs
GET /v1/xmltv?country=IRA country or a set of channels as a standard XMLTV file, up to 14 days ahead, for media centres and IPTV players.Live and aboveDocs
curl -H "Authorization: Bearer $TVG_KEY" \
  "https://api.tvguideapi.com/v1/countries/IR/now"
What is on now on every channel in Iran, in one call
// GET /v1/countries/IR/now, one channel, in short
{
    "data": [
        {
            "channel": "ch_jbcfk7n5",
            "now": {
                "start": "2026-11-06T19:00:00Z",
                "stop": "2026-11-06T21:00:00Z",
                "title": "Speed",
                "progress": 0.36
            },
            "next": {
                "start": "2026-11-06T21:00:00Z",
                "title": "Privacy Policy"
            }
        }
    ],
    "meta": {
        "count": 19,
        "at": "2026-11-06T19:45:03Z"
    }
}
Real titles, kept 10 minutesEvery field
SportSport on TV in Iran this week

The key competitions first, then the rest with a named competition. Every event and every channel is GET /v1/events?country=IR.

Kick-offEventCompetitionChannelsShowing
No sport listed for Iran this week yet.
Channel mixWhat Iran's channels carry

By category and by owner, from the channel registry.

By category

General4
Religious3
Culture2
News2
Sport2
Children2
Films1

Biggest owners

IRIB8
Islamic Republic of Iran Broadcasting3
Seyyed Mohammad Ali Mousavi Jazayeri1

The Iran TV guide, in brief

The TV guide for Iran covers 19 channels, 19 of them with a schedule today. Every time on this page is Asia/Tehran, and its listings history reaches back to 2026.

Most of Iran's channels are general, religious and culture channels, and the biggest owners are IRIB, Islamic Republic of Iran Broadcasting and Seyyed Mohammad Ali Mousavi Jazayeri.

Developers get the same data from the TV Guide API: every channel in Iran with GET /v1/countries/IR/channels, what is on now with GET /v1/countries/IR/now, and a full day with GET /v1/guide?country=IR.

Who uses it

Apps and set-top boxesThe full Iran line-up and schedule.
Bars and hotelsLive sport on Iran's channels tonight.
TravellersWhat is on in Iran, in local time.
ResearchWhat aired in Iran, and when.

Questions

How many TV channels does Iran have?

We list 19 channels in Iran, 19 of them with a schedule today.

How far ahead does the Iran TV guide go?

Today's listings are held for its main channels; days ahead fill in as its guides publish them.

What time zone are Iran TV times in?

This page shows Asia/Tehran. The API returns UTC and converts to any time zone you pass.

How do I get Iran's TV listings in my app?

With a TV Guide API key: GET /v1/countries/IR/now for what is on now, or GET /v1/guide?country=IR for a whole day. The free key reads yesterday.

More countriesMost listed countries

Every country has one page like this one. Channel by channel detail lives in the API: every country.

Every Iran channel, in one API call