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.
Catchup availability
Each channel has its own catchup availability window configured (if the catchup service is available at all). The window is configured as a catchup "length", indicating for how long a program is supposed to be available as catchup after it has aired. A program is available as catchup from the point when its live broadcast ends for the amount of time indicated by the channel's catchup length. This means all programs are available as catchup for the same amount of time regardless of the length of the program.
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. |
/api/catchup/v4/broadcast_slots/most_popular | GET | Get a list of the most watched catchup content available across all channels. |
...
| Endpoint | HTTP method | Purpose |
|---|---|---|
/api/v1/catchup/<broadcastSlotId>/relationships/streams | GET | Get information about playback streams which belong to a Broadcast Slot |
Use the catchup streams endpoint to get the playback streams for a catchup asset.
...