# Kick Channel Clips API Documentation

Retrieve the clip feed of one channel with playback and thumbnail URLs, creator and category details, views, likes, and duration. Kick fixes the page size at 20 and ignores a page-size parameter, so pagination advances with the next_cursor value returned here.

- **Documentation:** [https://scrappa.co/docs/kick-api/kick_channel_clips](https://scrappa.co/docs/kick-api/kick_channel_clips)
- **API group:** Kick API
- **Endpoint:** `GET https://scrappa.co/api/kick/v1/channels/{slug}/clips`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `slug` | string | Yes | Kick channel slug. |
| `sort` | string | No | Clip sort. Only view is supported. |
| `time` | string | No | all, day or week. Defaults to all. |
| `cursor` | string | No | Opaque cursor returned as pagination.next_cursor by the previous page. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/kick/v1/channels/{slug}/clips?slug=xqc&sort=view&time=week"
```

## Example response

```json
{
    "success": true,
    "data": {
        "clips": [
            {
                "id": "clip-1",
                "views": 12000,
                "clip_url": "https://example/clip.mp4"
            }
        ],
        "pagination": {
            "page_size": 20,
            "count": 20,
            "has_more": true,
            "next_cursor": "eyJpZCI6MTIzfQ=="
        },
        "search_parameters": {
            "slug": "xqc",
            "sort": "view",
            "time": "week",
            "cursor": null
        }
    },
    "meta": {
        "upstream_family": "clips"
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 404 | Not Found | The requested channel, clip, video, or subcategory does not exist. This response is not billable. |
| 422 | Validation Error | A public parameter is invalid, such as an unsupported clip sort or an empty search query. This response is not billable. |
| 502 | Invalid Source Response | Kick returned a response shape the API does not recognise. This response is not billable. |
| 503 | Service Unavailable | The service could not obtain a complete result from Kick. This response is not billable. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)