Skip to Content
Cut.ProDocs
Live clipping: monitored channels

List clips of a broadcast

Returns the clips this workspace got from one broadcast, best rated first by default. While the broadcast is on air, new clips land every 10 minutes, so poll this list rather than waiting for the broadcast to end.

A clip with an edit_id is ready to render or post; one without it renders with the default layout through POST /monitors/{id}/broadcasts/{broadcastId}/clips/{clipId}/render. Returns 410 once the recording was purged.

Authorization

apiKey
headerX-Api-Key<token>

Path Parameters

id*string

Monitor id, from GET /monitors

Match^[0-9]{1,19}$
broadcastId*string

Broadcast id, from GET /monitors/{id}/broadcasts

Query Parameters

page?number

Page number (default: 1)

Range1 <= value
limit?number

Items per page (default: 20, max: 100)

Range1 <= value <= 100
sort?string
Value in"rating""duration""title""created_at"
order?string
Value in"asc""desc"
min_rating?number

Only clips with rating at or above this value

Range0 <= value <= 10
max_rating?number

Only clips with rating at or below this value

Range0 <= value <= 10

Response Body

Response for status 200

application/json
  1. response
clips*array<>
pagination*
GET
/monitors/{id}/broadcasts/{broadcastId}/clips
Example Request
curl -X GET 'https://api.cut.pro/api/v1/monitors/string/broadcasts/string/clips'
Example Response
{  "clips": [    {      "id": "string",      "title": "string",      "description": null,      "rating": 0,      "started_at": "string",      "ended_at": "string",      "start": 0,      "end": 0,      "duration": 0,      "thumbnail_url": null,      "play_url": "string",      "edit_id": null,      "render_id": null,      "rendering": true,      "edited": true    }  ],  "pagination": {    "current_page": 0,    "total_pages": 0,    "total_count": 0,    "has_next_page": true,    "has_previous_page": true,    "limit": 0  }}