The "Catchup" service allows users to watch broadcast content for a limited amount of time after it has aired on a channel providing the catchup service. Catchup works similarly to recordings, in the sense that it is on-demand video that has been recorded from the live stream, but the service is licensed separately to users, it is available without specific input from the user, its availability is more limited, and catchup content does not count towards the user's recording storage quota.
Endpoints overview
| Endpoint | HTTP method | Purpose |
|---|---|---|
/api/catchup/v4/broadcast_slots/{channel_id} | GET | Get a list of catchup content available for a given channel. |
Viewing Catchup per channel
A list of available Catchup content can be retrieved using the get catchup by channel endpoint. The amount of content returned depends on the channels configured catchup length. All aired content since current time minus the channel's catchup length is returned, except for individually blacklisted broadcast slots.
The endpoint includes the series resources in the response, allowing for convenient grouping of the content by series.
Migration from legacy
The legacy endpoint /api/user/<userEmail:>/recording/catchup is replaced by the get catchup by channel endpoint.