{pid}: Get episode details

API: co.uk:bbc-iplayer-business-layer-api
Endpoint: /episodes/{pid}
Response format: application/json
Auth: unknown
Method: GET
Last Status: 200
Latency: 201ms

Description

Returns comprehensive details for an individual episode including title, synopsis, availability windows, broadcast dates, images, and version information (HD, download availability). Use this to display episode details or check if an episode is available to watch.

From spec: Returns detailed information about a specific episode including versions, availability, and playback metadata.

Usage Tips

- Episode PID is an alphanumeric identifier (e.g., b037vzl7, m002tfrm) - Includes availability start/end dates showing when content expires - Returns version details including HD availability and download options - Guidance warnings are provided where applicable

Parameters (1)

pid (string, path, required)

Episode ID (PID) - e.g., m002thdq

Examples (1)

Get episode details for Abadas S2E26 probe-gate

Demonstrates fetching detailed information about a specific episode by its PID

curl 'https://ibl.api.bbci.co.uk/ibl/v1/episodes/b037vzl7'
import requests

resp = requests.get("https://ibl.api.bbci.co.uk/ibl/v1/episodes/b037vzl7")
data = resp.json()
import zingu_apis

api = zingu_apis.api("bbc-iplayer-business-layer")
result = api.fetch("episodes/{pid}")

for item in result:
    print(item)
const resp = await fetch("https://ibl.api.bbci.co.uk/ibl/v1/episodes/b037vzl7");
const data = await resp.json();

Probe History

Latency

Status Codes

TimeStatusLatencySize
2026-04-16 01:57:36.440303 200 201ms
2026-04-15 04:12:39.307685 200 182ms
2026-04-14 03:52:27.236735 200 203ms
2026-04-12 12:31:41.797830 200 166ms
2026-04-10 01:19:40.344326 200 112ms
2026-04-09 03:39:55.635798 200 128ms