Get a broadcast
Returns one broadcast of a live monitor with how its clipping went: clips, ratings and credits charged. While it is on air, next_batch says when the next clips land. 400 INVALID_OBSERVING_TYPE on a video monitor; 404 STREAM_NOT_FOUND when the broadcast is not this channel's.
apiKeyX-Api-Key<token>id*stringMonitor id, from GET /monitors
^[0-9]{1,19}$broadcastId*stringBroadcast id, from GET /monitors/{id}/broadcasts
Response for status 200
application/json- response
id*stringThe platform's own id for the broadcast
title*stringcategory*stringGame or category the channel set for the broadcast; empty when none
language*stringis_mature*booleantags*array<string>started_at*stringISO 8601 timestamp of when the broadcast went on air
ended_at*||ISO 8601 timestamp of when it went off air; null while it is still live
thumbnail_url*string|null|nullplay_url*||Signed URL to stream our recording, time-limited; null once it was purged
source_url*||The broadcast's replay on the platform, once it ended and the platform keeps one
recording_expired*booleantrue once the recording was purged: its clips can no longer be listed or rendered
next_batch*||Progress of the next batch; null unless the broadcast is on air and the monitor is on
clips_count*numberClips this workspace got from the broadcast
average_rating*||Average rating of its clips, 0 to 10; null without clips
best_rating*||Highest rating among its clips; null without clips
clips_duration*numberSum of the clips' length, in seconds
credits_used*numberCredits charged for this broadcast's batches
batches_count*numberBatches charged for this broadcast
curl -X GET 'https://api.cut.pro/api/v1/monitors/string/broadcasts/string'{ "id": "string", "title": "string", "category": "string", "language": "string", "is_mature": true, "tags": [ "string" ], "started_at": "string", "ended_at": null, "thumbnail_url": null, "play_url": null, "source_url": null, "recording_expired": true, "next_batch": null, "clips_count": 0, "average_rating": null, "best_rating": null, "clips_duration": 0, "credits_used": 0, "batches_count": 0}List broadcasts of a live monitor GET
Returns the channel's broadcasts, newest first, each with how many clips this workspace got from it. A broadcast with `ended_at: null` is on air and keeps producing clips every 10 minutes while the monitor is on. Only `live` monitors have broadcasts: a `video` monitor answers `400 INVALID_OBSERVING_TYPE`, and its clips arrive as regular submissions in `GET /videos`.
List clip IDs of a broadcast GET
Returns the IDs of every clip of a broadcast that matches the filters, in the same order as the clip list, without pagination. Use it to select clips for `apply_template` or `delete`. `sort`: `rating` (default), `duration`, `title` or `created_at`; `order`: `desc` (default) or `asc`.