# Search Autocomplete

<p>Complete a partial search term the way Rumble's own search box does. Rumble suggests matching channels (and user profiles) and video categories rather than text completions, so the response returns both as normalised <code>channels</code> and <code>categories</code> lists, plus one merged <code>suggestions</code> list (channels first, then categories) that a search box can render directly. <code>count</code> is the number of merged suggestions returned. A term nothing matches returns empty lists as a successful, billed response. This action rate limits on some connections, so it fails as an unbillable retryable error rather than slowing down any other endpoint.</p>

- **Documentation:** [https://scrappa.co/docs/rumble-api/rumble_search_autocomplete](https://scrappa.co/docs/rumble-api/rumble_search_autocomplete)
- **API group:** Rumble API
- **Endpoint:** `GET https://scrappa.co/api/rumble/search/autocomplete`

## 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 | <p>Partial search term to complete.</p> |
| `limit` | integer | No | <p>Maximum suggestions to return, 1 to 20 (default 10). Applied to the merged <code>suggestions</code> list and to each of <code>channels</code> and <code>categories</code>.</p> |

## Example response

```json
{
    "meta": {
        "attempts": 1,
        "duration_ms": 914,
        "endpoint_family": "search.autocomplete"
    },
    "count": 3,
    "query": "news",
    "channels": [
        {
            "id": "_c316725",
            "url": "https://rumble.com/c/NewsmaxTV",
            "name": "NEWSMAX",
            "slug": "NewsmaxTV",
            "type": "channel",
            "banner": "https://hugh.cdn.rumble.cloud/video/z8/1/u/n/b/1unba.caa.1-NewsmaxTV-qu1fe1.jpeg",
            "handle": "NewsmaxTV",
            "videos": 13287,
            "verified": true,
            "followers": 1303569,
            "thumbnail": "https://hugh.cdn.rumble.cloud/video/z8/1/u/n/b/1unba.baa.1-NewsmaxTV-qu1fdv.jpeg",
            "badge_type": "premium",
            "description": "Watch NEWSMAX, an independent news network with a conservative perspective, available in 100M+ U.S. homes.",
            "watching_now": null
        },
        {
            "id": "_ukqd4p",
            "url": "https://rumble.com/user/RealAmericasVoice",
            "name": "RealAmericasVoice",
            "slug": "RealAmericasVoice",
            "type": "user",
            "banner": null,
            "handle": "RealAmericasVoice",
            "videos": 76890,
            "verified": true,
            "followers": 179799,
            "thumbnail": null,
            "badge_type": null,
            "description": null,
            "watching_now": null
        }
    ],
    "has_more": false,
    "categories": [
        {
            "id": 5,
            "slug": "news",
            "title": "News",
            "viewers": 11857,
            "thumbnail": "https://hugh.cdn.rumble.cloud/video/z13/f/a/a/a/faaaa.aaa.3.jpeg",
            "is_primary": true,
            "description": "Your daily source of news from all over the world, all in one place!"
        }
    ],
    "suggestions": [
        {
            "id": "_c316725",
            "url": "https://rumble.com/c/NewsmaxTV",
            "slug": "NewsmaxTV",
            "type": "channel",
            "title": "NEWSMAX",
            "thumbnail": "https://hugh.cdn.rumble.cloud/video/z8/1/u/n/b/1unba.baa.1-NewsmaxTV-qu1fdv.jpeg"
        },
        {
            "id": "_ukqd4p",
            "url": "https://rumble.com/user/RealAmericasVoice",
            "slug": "RealAmericasVoice",
            "type": "user",
            "title": "RealAmericasVoice",
            "thumbnail": null
        },
        {
            "id": 5,
            "url": null,
            "slug": "news",
            "type": "category",
            "title": "News",
            "thumbnail": "https://hugh.cdn.rumble.cloud/video/z13/f/a/a/a/faaaa.aaa.3.jpeg"
        }
    ],
    "channels_count": 2,
    "categories_count": 1
}
```

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