# Currys Search API Documentation

<p>Read public logged-out product results as JSON. Search by query or category path, page with size, sort and GBP price bounds. Ids pass unchanged to the product and reviews routes. Sort and price bounds apply to the returned page, not across all pages. Empty results are not billed.</p>

- **Documentation:** [https://scrappa.co/docs/currys-api/currys_search](https://scrappa.co/docs/currys-api/currys_search)
- **API group:** Currys API
- **Endpoint:** `GET https://scrappa.co/api/currys/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 query. Required unless category is given. |
| `category` | string | No | Public category path. |
| `page` | integer | No | 1-based page, default 1. |
| `size` | integer | No | Results per page, 1 to 40. |
| `sort` | string | No | relevance, price_asc, price_desc or rating. |
| `min_price` | number | No | Minimum GBP price. |
| `max_price` | number | No | Maximum GBP price. |

## Example response

```json
{
    "data": {
        "products": [
            {
                "id": "10304092",
                "name": "Example TV",
                "brand": "Example",
                "price": 279,
                "rating": 4.4,
                "currency": "GBP",
                "discount": 50,
                "availability": "InStock",
                "review_count": 66,
                "original_price": 329
            }
        ],
        "pagination": {
            "has_more": true,
            "per_page": 20,
            "current_page": 1
        }
    },
    "meta": {
        "credits": 1,
        "billable": true,
        "endpoint_family": "currys.search"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A filter is invalid. Not billed. |
| 503 | Upstream Unavailable | The source is temporarily unavailable. 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)
