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).
apiKeyX-Api-Key<token>- body
channel?stringChannel URL, e.g. https://www.youtube.com/@handle, https://www.twitch.tv/login or https://kick.com/slug
creator_id?stringcreator_id from GET /monitors/search or GET /monitors/discover, instead of channel
^[0-9]{1,19}$type*string"live""video"enabled?booleanStart monitoring right away. Defaults to true
strategy_id?stringID of a clipping strategy. On create, omit to use the default AI settings
^[0-9]{1,19}$template_id?||ID of an edit template from GET /templates; null = none
^[0-9]{1,19}$video_min_duration?|1 <= value <= 3600video_max_duration?|1 <= value <= 3600days_of_week?array<|>hours_of_day?array<array<|>>Response for status 201
application/json- response
id*stringMonitor id, used in every /monitors/{id} route
platform*string"youtube""twitch""kick"username*stringChannel handle on the platform
display_name*||Channel name as shown on the platform
avatar_url*string|null|nullenabled*booleantrue 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*stringClipping strategy applied to every clip
template_id*||Edit template applied to every clip; null = none
type*"live""live"on_air*booleantrue while the channel is broadcasting
broadcasts_count*numberBroadcasts recorded since the channel was first monitored
clips_count*numberClips 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*numberCredits the next 10-minute batch of this channel costs your workspace, after any discount
curl -X POST 'https://api.cut.pro/api/v1/monitors' \ -H 'Content-Type: application/json' \ -d '{ "type": "live"}'{ "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}List monitored channels GET
Returns the channels this workspace monitors, newest first, with whether each one is on, the settings its clips use and, for a `live` monitor, whether the channel is on air, its counts and what its next batch costs.
Search channels to monitor GET
Searches YouTube, Twitch or Kick for channels by name, best match first, at most 20. Monitor one by passing its `creator_id` to `POST /monitors`. Refusals: `400 QUERY_REQUIRED`, `400 INVALID_PLATFORM` (also for a platform your plan does not monitor), `500 SEARCH_FAILED` when the platform did not answer, and `429` (30 per minute).