71.8M listings
Every country's schedule under one key, one shape and one set of ids.
GET /v1/now
What every channel in a country is showing this minute, with the next programme after it.
MIT, no lock-in
Every lab tool reads only the public API with your own key, so it runs on the free key.
Working normally
Checked every minute from outside our own servers.
The channel directory: names, aliases, owners, categories, launch years and websites, with one stable id across every guide that lists the channel.
| Endpoint | What it gives | Plan |
|---|---|---|
| GET /v1/channels | Every TV channel in the registry, filtered by country, language, category or logo, with one stable id per channel across all our sources. | Free key |
| GET /v1/channels/search | Find a TV channel by its name, an alias or a call sign, in any country, and get the id every other endpoint takes. | Free key |
| GET /v1/channels/{id} | One TV channel in full: its names, owner, country, languages, categories, logo, website, launch year and the guide feeds behind it. | Free key |
| GET /v1/countries | Every country we hold TV listings for, with its channel count, its guide feeds and how many programmes it has today. | Free key |
| GET /v1/countries/{cc}/channels | Every TV channel in one country, ordered the way its own guides list them, with ids, names, logos and categories. | Free key |
{
"data": [
{
"id": "ch_jw83a3xg",
"name": "BBC One",
"country": "GB",
"languages": [
"eng"
],
"categories": [
"general"
],
"owner": "BBC",
"launched": 1936,
"website": "https://www.bbc.co.uk/bbcone",
"feeds": 3
}
],
"meta": {
"count": 612,
"next": "c_8f21a0",
"took_ms": 41
}
}