# Chrome Web Store Search

Search the public Chrome Web Store by query or category and return result cards with extension id, name, icon, rating, review count, users and category. Page through results with a continuation token.

- **Documentation:** [https://scrappa.co/docs/chrome-web-store-api/chrome_web_store_search](https://scrappa.co/docs/chrome-web-store-api/chrome_web_store_search)
- **API group:** Chrome Web Store API
- **Endpoint:** `GET https://scrappa.co/api/chrome/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 | No | Search terms. Exactly one of q or category is required. |
| `category` | string | No | Category slug from a result card. |
| `hl` | string | No | Interface language: en, en-us or de. |
| `page` | integer | No | Page number. After page 1 a token is required. |
| `token` | string | No | next_page_token from a previous response. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/chrome/search?q=productivity"
```

## Example response

```json
{
    "search_parameters": {
        "engine": "chrome_web_store_search",
        "mode": "query",
        "q": "productivity",
        "category": null,
        "hl": "en",
        "page": 1,
        "token": null
    },
    "organic_results": [
        {
            "id": "aapbdbdomjkkjkaonfhkkikfgjllcleb",
            "name": "Google Translate",
            "icon": "https://lh3.googleusercontent.com/example",
            "rating": 4.6,
            "rating_count": 125000,
            "users": 10000000,
            "category": "productivity/communication"
        }
    ],
    "pagination": {
        "next_page_token": "example-continuation-token"
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A search parameter failed validation. |
| 503 | Chrome Web Store Unavailable | Upstream could not be fetched. The request is not billed. |

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