# Tesco Groceries Search API Documentation

<p>Search public Tesco Groceries products. Items carry GBP price, unit price, Clubcard price, promotion, stock flag, image and rating. Sort by relevance or price and filter by facet, price range or offers. Price and offer filters apply to the current page; filtered_out reports dropped items and total is the unfiltered upstream total. Pages are never relabelled. 1 credit per successful request with data.</p>

- **Documentation:** [https://scrappa.co/docs/tesco-api/tesco_search](https://scrappa.co/docs/tesco-api/tesco_search)
- **API group:** Tesco Groceries API
- **Endpoint:** `GET https://scrappa.co/api/tesco/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 text, for example milk. |
| `page` | integer | No | Page from 1 to 20, default 1. |
| `sort` | string | No | relevance, price-ascending or price-descending. |
| `min_price` | number | No | Minimum GBP price. |
| `max_price` | number | No | Maximum GBP price. |
| `offer` | boolean | No | Only products with a promotion. |
| `category` | string | No | Facet id from the taxonomy. |

## Example response

```json
{
    "data": {
        "page": 1,
        "sort": "relevance",
        "items": [
            {
                "id": "254656543",
                "name": "British Semi Skimmed Milk",
                "price": 1.75,
                "currency": "GBP",
                "unit_price": 0.77,
                "unit_of_measure": "litre"
            }
        ],
        "query": "milk"
    },
    "meta": {
        "credits": 1,
        "endpoint_family": "search"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Filter Not Honoured | A requested filter or id was rejected. |
| 503 | Source Unavailable | The public source could not be reached. |

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