Skip to Content
Cut.ProDocs
Live clipping: monitored channels

Search channels to monitor

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).

Authorization

apiKey
headerX-Api-Key<token>

Query Parameters

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

Channel name or handle

Length1 <= length <= 100

Response Body

Response for status 200

application/json
  1. response
channels*array<>
GET
/monitors/search
Example Request
curl -X GET 'https://api.cut.pro/api/v1/monitors/search?platform=youtube&q=string'
Example Response
{  "channels": [    {      "creator_id": "string",      "platform": "youtube",      "username": "string",      "display_name": null,      "avatar_url": null,      "description": null,      "followers": 0    }  ]}