# Kick Search API Documentation

Search Kick with one proxied lookup, returning matching channels, live streams, and categories with follower counts, live flags, thumbnails, and tags. An empty query is rejected with a 422 before any upstream call. Use mode=slim for the lighter variant of the same three collections.

- **Documentation:** [https://scrappa.co/docs/kick-api/kick_search](https://scrappa.co/docs/kick-api/kick_search)
- **API group:** Kick API
- **Endpoint:** `GET https://scrappa.co/api/kick/v1/search`

## 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 |
| --- | --- | --- | --- |
| `query` | string | Yes | Search text. Required and must not be empty. |
| `mode` | string | No | rich for the enriched result, slim for the lighter one. Defaults to rich. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/kick/v1/search?query=music&mode=rich"
```

## Example response

```json
{
    "success": true,
    "data": {
        "channels": [
            {
                "slug": "xqc",
                "follower_count": 4100000,
                "is_live": true
            }
        ],
        "livestreams": [
            {
                "id": "stream-1",
                "title": "Music night"
            }
        ],
        "categories": [],
        "pagination": {
            "count": 2,
            "has_more": false,
            "upstream_paginated": false
        },
        "search_parameters": {
            "query": "music",
            "mode": "rich"
        }
    },
    "meta": {
        "upstream_family": "search"
    }
}
```

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