# CoinMarketCap Search API Documentation

<p><strong>CoinMarketCap Search API Documentation</strong> Search the cached CoinMarketCap coin corpus by name, symbol or slug. Results include the numeric id, slug and contract address. Pass an id or slug into coin, history and markets without changing it. The corpus is cached and no external key is used. Filter by page and per_page (1 to 250). An empty answer and every failed request cost no credit. Cost: 1 credit per successful request. Scrappa is an independent service and is not affiliated with or endorsed by CoinMarketCap.</p>

- **Documentation:** [https://scrappa.co/docs/coinmarketcap-api/coinmarketcap_search](https://scrappa.co/docs/coinmarketcap-api/coinmarketcap_search)
- **API group:** CoinMarketCap API
- **Endpoint:** `GET https://scrappa.co/api/coinmarketcap/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 |
| --- | --- | --- | --- |
| `q` | string | Yes | Search text, e.g. bitcoin. |
| `page` | integer | No | Page number, 1-based. |
| `per_page` | integer | No | Rows per page, 1 to 250. |

## Example response

```json
{
    "data": {
        "query": "bitcoin",
        "search": [
            {
                "id": 1,
                "name": "Bitcoin",
                "rank": 1,
                "slug": "bitcoin",
                "type": "coin",
                "symbol": "BTC"
            }
        ],
        "pagination": {
            "page": 1,
            "total": 3,
            "has_more": false,
            "per_page": 100,
            "total_pages": 1
        }
    },
    "meta": {
        "source": "coinmarketcap",
        "credits": 1,
        "billable": true,
        "endpoint_family": "search"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A query parameter is missing or invalid. This response is not billable. |
| 503 | Service Unavailable | The search corpus is temporarily unavailable. 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)
