Skip to Content
Cut.ProDocs
Live clipping: monitored channels

Monitor a channel

Starts watching a YouTube, Twitch or Kick channel, from its URL in channel or from a creator_id that GET /monitors/search or GET /monitors/discover returned. A live monitor clips each broadcast while it airs, charged per 10-minute batch; a video monitor clips each new upload. It is born on unless enabled is false, which is how a 24/7 stream is set up once and then switched with start and stop. Refusals: 400 (CHANNEL_REQUIRED when neither channel nor creator_id is sent), 402, 403, 404, 409 ALREADY_MONITORING, and 429 (10 per minute, because it looks the channel up on the platform).

Authorization

apiKey
headerX-Api-Key<token>

Request Body

  1. body
channel?string

Channel URL, e.g. https://www.youtube.com/@handle, https://www.twitch.tv/login or https://kick.com/slug

creator_id?string

creator_id from GET /monitors/search or GET /monitors/discover, instead of channel

Match^[0-9]{1,19}$
type*string
Value in"live""video"
enabled?boolean

Start monitoring right away. Defaults to true

strategy_id?string

ID of a clipping strategy. On create, omit to use the default AI settings

Match^[0-9]{1,19}$
template_id?||

ID of an edit template from GET /templates; null = none

Match^[0-9]{1,19}$
video_min_duration?|
Range1 <= value <= 3600
video_max_duration?|
Range1 <= value <= 3600
days_of_week?array<|>
hours_of_day?array<array<|>>

Response Body

Response for status 201

application/json
  1. response
id*string

Monitor id, used in every /monitors/{id} route

platform*string
Value in"youtube""twitch""kick"
username*string

Channel handle on the platform

display_name*||

Channel name as shown on the platform

avatar_url*string|null|null
enabled*boolean

true while the monitor is on. It can also turn itself off when the balance runs out

enabled_at*||

ISO 8601 timestamp of when the current monitoring period started; null while off. Stopping is refused for the first 10 minutes after it.

strategy_id*string

Clipping strategy applied to every clip

template_id*||

Edit template applied to every clip; null = none

type*"live"
Value in"live"
on_air*boolean

true while the channel is broadcasting

broadcasts_count*number

Broadcasts recorded since the channel was first monitored

clips_count*number

Clips this workspace got from the channel's broadcasts whose recording is still kept

last_broadcast_at*||

ISO 8601 timestamp of when the latest broadcast started

thumbnail_url*||

Cover of the latest broadcast. Signed URL, time-limited

next_batch*||

Progress of the next batch; null unless the broadcast is on air and the monitor is on

batch_credits*number

Credits the next 10-minute batch of this channel costs your workspace, after any discount

POST
/monitors
Example Request
curl -X POST 'https://api.cut.pro/api/v1/monitors' \  -H 'Content-Type: application/json' \  -d '{  "type": "live"}'
Example Response
{  "id": "string",  "platform": "youtube",  "username": "string",  "display_name": null,  "avatar_url": null,  "enabled": true,  "enabled_at": null,  "strategy_id": "string",  "template_id": null,  "type": "live",  "on_air": true,  "broadcasts_count": 0,  "clips_count": 0,  "last_broadcast_at": null,  "thumbnail_url": null,  "next_batch": null,  "batch_credits": 0}