# Kick Category Clips API Documentation

Retrieve the clip feed of one subcategory, with the same fixed page size and opaque cursor as the global clip feed. The subcategory must be given as its slug, which the subcategories endpoint returns.

- **Documentation:** [https://scrappa.co/docs/kick-api/kick_category_clips](https://scrappa.co/docs/kick-api/kick_category_clips)
- **API group:** Kick API
- **Endpoint:** `GET https://scrappa.co/api/kick/v1/categories/{subcategory_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 |
| --- | --- | --- | --- |
| `subcategory_slug` | string | Yes | Subcategory slug, for example just-chatting. |
| `sort` | string | No | Clip sort. Only view is supported. |
| `time` | string | No | all, day or week. Defaults to all. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/kick/v1/categories/{subcategory_slug}/clips?subcategory_slug=just-chatting&sort=view"
```

## Example response

```json
{
    "success": true,
    "data": {
        "clips": [
            {
                "id": "clip-7",
                "views": 5100
            }
        ],
        "pagination": {
            "page_size": 20,
            "count": 20,
            "has_more": false,
            "next_cursor": null
        },
        "search_parameters": {
            "subcategory_slug": "just-chatting",
            "sort": "view",
            "time": "all",
            "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)