Clips API
Use these actions to look up and download Kick clips.
Each action is a REST endpoint under https://kickbot.com/api/v1 and an MCP tool with the same name. The MCP area name is clips. Use it to load only this area: https://kickbot.com/api/v1/mcp?areas=clips.
A team member needs one of these permissions in Manage Team: Clip downloader or Manage clips. Some actions need a specific one (the action says so). Owners and admins have every permission. Write actions also need a read and write key or connection. See Permissions and security.
How the feature works in the dashboard: Clip downloader, Clip pages.
Actions
Section titled “Actions”| Tool | REST | Access |
|---|---|---|
list_clip_downloads | GET /clips/downloads | Read |
get_kick_clip | GET /clips/kick | Read |
start_clip_download | POST /clips/downloads | Write |
list_clip_downloads
Section titled “list_clip_downloads”List Kick clip downloads. List the Kick clips you asked KickBot to download, newest first, with their status (queued, in progress, complete, failed) and the download_url when complete. Call it again to check the status of a new download.
GET /api/v1/clips/downloads| Field | Type | Required | Description |
|---|---|---|---|
limit (query) | integer | No | Max items to return (1-100, default 50). |
offset (query) | integer | No | Number of items to skip (default 0). |
get_kick_clip
Section titled “get_kick_clip”Look up a Kick clip. Look up a clip on Kick (title, channel, length, views, thumbnail) before downloading it. Any public Kick clip works, not only clips of your channel.
GET /api/v1/clips/kickThis has an effect outside your settings (for example on your live stream).
| Field | Type | Required | Description |
|---|---|---|---|
clip (query) | string | Yes | The Kick clip URL (https://kick.com/<channel>/clips/<clip id>) or only the clip id (for example clip_01HX…). |
start_clip_download
Section titled “start_clip_download”Download a Kick clip. Start downloading a Kick clip as an MP4. KickBot looks the clip up on Kick itself, so send only its URL or id. The download usually takes under a minute; check list_clip_downloads for the status and download_url.
POST /api/v1/clips/downloadsNeeds a read and write key or connection. This has an effect outside your settings (for example on your live stream). Rate limit: 10 per minute, 100 per day.
| Field | Type | Required | Description |
|---|---|---|---|
clip | string | Yes | The Kick clip URL (https://kick.com/<channel>/clips/<clip id>) or only the clip id (for example clip_01HX…). |