# Boots Product Search API Documentation

`GET /api/boots/search` `GET /api/boots/search` returns public Boots products as structured JSON. Use `query` or `category`. `brand` removes rows of another brand. `page` is zero-based and comes from the source, so page one is never labelled as another page. `sort` accepts only mostRelevant, priceLowToHigh, topRated and newest. Prices are numbers with currency GBP; regular, current, saving and perUnit are separate. Advantage points and deal flags stay in their own fields and are never merged into the ordinary price. Ratings and review counts are numbers. `image_url` is a full-size image URL. `in_stock` is online stock only. Store stock, suggest and a price filter are not published yet.

## Credits

A successful request costs **3 credits**. Errors and challenges cost nothing. The response shows the charge in `meta.credits_charged`. Clients are never rate limited.

- **Documentation:** [https://scrappa.co/docs/boots-api/boots_search](https://scrappa.co/docs/boots-api/boots_search)
- **API group:** Boots API
- **Endpoint:** `GET https://scrappa.co/api/boots/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 words (use this or category). |
| `category` | string | Yes | Category filter (use this or query). |
| `brand` | string | No | Exact brand. |
| `page` | integer | No | Zero-based page index. |
| `size` | integer | No | Page size, 1 to 200. |
| `sort` | string | No | mostRelevant, priceLowToHigh, topRated or newest. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/boots/search?query=moisturiser"
```

## Example response

```json
{
    "success": true,
    "currency": "GBP",
    "items": [
        {
            "object_id": "10389493",
            "title": "Example moisturiser",
            "brand": "No7",
            "pricing": {
                "current": {
                    "value": 12.95,
                    "currency": "GBP"
                }
            },
            "reviews": {
                "average": 4.5,
                "count": 120
            },
            "in_stock": true
        }
    ],
    "page": 0,
    "total": 2717,
    "meta": {
        "endpoint_family": "E01",
        "billable": true,
        "attempts": 1,
        "credits_charged": 3
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 404 | Not Found | No product is available for that id (`not_found`). Non-billable. |
| 422 | Validation Error | A parameter is missing, unknown or invalid. Unknown parameters, including an unpublished price filter, are rejected. Non-billable. |
| 503 | Upstream Unavailable | The source could not be reached, answered with a challenge, or changed its shape (`upstream_blocked`, `upstream_unavailable`, `parser_drift`). Never billed. Clients are never rate limited. |

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