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 programme on now on every channel, how far through it is, and what comes next: for one channel, a list of channels or a whole country.
| Endpoint | What it gives | Plan |
|---|---|---|
| GET /v1/now | What is on now on the TV channels you name, or across a whole country, with what comes next on each. | Free key |
| GET /v1/next | The next programme on each of the TV channels you name, or across a whole country. | Free key |
| GET /v1/channels/{id}/now | What is on a TV channel right now and what comes next, with how far through the current programme it is. | Free key |
| GET /v1/channels/{id}/next | The next programmes on a TV channel, as many as you ask for, each with its times in UTC and its episode where matched. | Free key |
| GET /v1/countries/{cc}/now | What is on now on every TV channel in a country, with what comes next, in one call. | Free key |
| GET /v1/countries/{cc}/tonight | Prime time tonight on every TV channel in a country, from the local hour you choose, in one grid. | Free key |
{
"data": [
{
"channel": "ch_jw83a3xg",
"now": {
"title": "EastEnders",
"start": "2026-10-07T19:00:00Z",
"stop": "2026-10-07T19:30:00Z"
},
"next": {
"title": "The One Show",
"start": "2026-10-07T19:30:00Z"
}
},
{
"channel": "ch_7qk3m2xa",
"now": {
"title": "Emmerdale",
"start": "2026-10-07T19:00:00Z",
"stop": "2026-10-07T19:30:00Z"
},
"next": {
"title": "Coronation Street",
"start": "2026-10-07T19:30:00Z"
}
}
],
"meta": {
"count": 120,
"next": "c_8f21a0",
"took_ms": 41
}
}