# Kick (/docs/kick)

Read a Kick clip (title, views, duration, category, creator, channel and thumbnail) from a clip URL

Kick is a live-streaming platform, and clips are the part of it that travels: a moment cut out of a stream, shared to X or TikTok, and often the first place a streamer's audience meets them. One endpoint reads a clip from its URL for 1 credit.

Base URL: `/v1/kick/...`

  Clips are the whole surface here. There is no channel endpoint, no live-stream
  state, no VOD list, and no chat on this platform. If you need a streamer's
  channel or schedule, [Twitch](/docs/twitch.md) covers that shape and Kick does
  not.

## Quickstart

### 1. Fetch a clip

```bash title="cURL"
curl "https://www.socialcrawl.dev/v1/kick/clip?url=https://kick.com/xqc/clips/clip_abc123" \
  -H "x-api-key: YOUR_API_KEY"
```

### 2. Read what came back

The response carries the clip's title, view count, duration, category, creator name, channel name, thumbnail URL, and creation time. The category is worth noting: it is what the streamer was broadcasting under at the moment of the clip, which is often a better description of the content than the clip title.

### 3. Read computed fields

When an endpoint supports a computed field and the required source inputs are present, the unified response includes that optional field. Depending on the endpoint, optional fields can include `engagement_rate`, `language`, `content_category`, and `estimated_reach`. See [Computed fields](/docs/computed-fields.md) for formulas, clamping rules, and null semantics.

## Clips

| Endpoint            | Credits | What it returns                                                                           | Key parameters  |
| ------------------- | ------- | ----------------------------------------------------------------------------------------- | --------------- |
| `GET /v1/kick/clip` | 1       | Title, view count, duration, category, creator, channel, thumbnail URL, and creation time | `url`, required |

The typical use is attribution. A Kick clip circulating on another platform carries only its URL, and this endpoint turns that URL into the channel, the creator, and the view count, which is what you need to credit it or to size it against clips from Twitch or YouTube.

## All endpoints

## Platform notes

**Views on a clip are cumulative and keep moving.** A clip fetched a week apart legitimately reports two different numbers. There is no snapshot semantics here.

**The URL must be a clip URL** in the form `kick.com/{channel}/clips/{clip_id}`, not a channel or VOD URL.

**Nothing on this platform paginates.**

## Next steps

- [Credits](/docs/credits.md): What each tier costs and when a call is refunded.
- [Errors](/docs/errors.md): What a 404 on a deleted clip looks like, and what it costs.
- [API reference](/docs/api-reference.md): Every parameter and response field, endpoint by endpoint.
- [Twitch](/docs/twitch.md): Channels, videos, schedules, and clips on the larger platform.
- [Rumble](/docs/rumble.md): Video, comments, transcripts, and keyword search.