The definitive iPlayer API.
Every row below was read from the vendor's own OpenAPI document. The summary text is theirs. What this registry adds is that each operation is indexed with its method, path, base URL and auth scheme, so a search for a capability can answer with a call rather than a name, and that the endpoint is probed on a schedule.
Specifications as held by the APIs.guru corpus, whose newest record is 2023-04-21. Operations the vendor has added since are not listed here; the origin links above are the vendor's own current documents.
base URLs: https://ibl.api.bbci.co.uk/ibl/v1 http://ibl.api.bbci.co.uk/ibl/v1
auth: a p i k e y
find it by capability: POST /search {"query":{"text":"..."}} returns these
operations with their invocation detail. Connect any agent client.
The definitive iPlayer API.
| method | path | what the vendor says it does |
|---|---|---|
GET | /atoz/{letter}/programmes | Programmes by initial title character Get the Programmes whose title begins with the given initial character. |
GET | /categories | Get categories Get the list of all the categories in TV & iPlayer. Categories |
GET | /categories/{category} | Get sub-categories Get sub-categories Categories |
GET | /categories/{category}/episodes | List all the episodes for a category. Get the list of all the episodes for a given category in TV & iPlayer. E |
GET | /categories/{category}/highlights | List the highlights for a category. Get the editorial highlights of a given category in TV & iPlayer. Programm |
GET | /categories/{category}/programmes | List all the programmes for a category. Get the list of all the Programmes (TLEOs) for a given category in TV |
GET | /channels | List all the channels. Get the list of all the channels TV & iPlayer. Channels |
GET | /channels/{channel}/broadcasts | Get broadcasts by channel Get broadcasts by channel Programmes (TLEOs) |
GET | /channels/{channel}/highlights | List the highlights for a channel. Get the editorial highlights of a given channel in TV & iPlayer. Channels |
GET | /channels/{channel}/programmes | Get programmes by channel Get programmes by channel Programmes (TLEOs) |
GET | /channels/{channel}/schedule/{date} | Get schedule by channel Get schedule by channel Channels |
GET | /clips/{pid} | Get Clips Get Clips Episodes |
GET | /episodes/{pid} | Episode for a given pid. Get the episode for a given episode identifier. Episodes |
GET | /episodes/{pid}/next | Get Onward Journey Get Onward Journey (next programme) Episodes |
GET | /episodes/{pid}/postrolls | Get Follow-ups (post-rolls) Get Follow-ups (post-rolls) Episodes |
GET | /episodes/{pid}/prerolls | Get Trailers (pre-rolls) Get Trailers (pre-rolls) Episodes |
GET | /episodes/{pid}/recommendations | Get programme recommendations Get programme recommendations Episodes |
GET | /groups/popular/episodes | Get programmes popular Get programmes popular Episodes |
GET | /groups/{pid}/episodes | Get episodes by group, brand or series Get episodes by group, brand or series Episodes |
GET | /home/highlights | Get programme highlights Get programme highlights Programmes (TLEOs) |
GET | /programmes/{pid} | Programme for a given pid. Get the programme for a given programme identifier. Programmes (TLEOs) |
GET | /programmes/{pid}/episodes | Child episodes for a given programme pid. Get the child episodes belonging to a given programme identifier. Ep |
GET | /regions | List all regions Get the list of all the regions TV & iPlayer. Regions |
GET | /schema/ibl.json | Get schema Get schema Metadata |
GET | /search | Search Search Search |
GET | /search-suggest | Search-suggest Search-suggest Search |
GET | /status | Get status Get the current iPlayer business layer status. This tells the caller the status of the iPlayer data |
GET | /user/purchases | Get user store purchases Get user store purchases User |
GET | /user/recommendations | Get user store recommendations Get user store recommendations User |
GET | /user/watching | Get user watching Get user watching User |
specification origin: https://raw.githubusercontent.com/Mermade/bbcparse/master/iblApi/openapi.yaml
nothing on this page is a rating, an endorsement or a claim about quality. Reachability is what our probes observed from one network; answering is a floor under usefulness, not a measure of it.