# Clips API

> KickBot API and MCP reference for clips: look up any public Kick clip, download it as an MP4 file, and list the clip downloads of your channel.

Source: https://kickbot.com/docs/api/reference/clips

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](https://kickbot.com/docs/api/start/permissions-and-security).

How the feature works in the dashboard: [Clip downloader](https://kickbot.com/docs/clips-vods/clip-downloader), [Clip pages](https://kickbot.com/docs/clips-vods/clip-pages).

## Actions

| Tool | REST | Access |
|---|---|---|
| [`list_clip_downloads`](#list_clip_downloads) | `GET /clips/downloads` | Read |
| [`get_kick_clip`](#get_kick_clip) | `GET /clips/kick` | Read |
| [`start_clip_download`](#start_clip_download) | `POST /clips/downloads` | Write |

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

```http
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

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

```http
GET /api/v1/clips/kick
```

This 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

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

```http
POST /api/v1/clips/downloads
```

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