# Lidl Online Shop Product Search API Documentation

`GET /api/lidl/search` returns products of the German Lidl Online Shop as structured JSON.

## What you get

Each item has `id`, `name`, `brand`, numeric EUR `price`, `original_price`, `discount_percent`, `rating`, `review_count`, `online_available`, a full-size `image`, `ean`, `offer_from` and `offer_to` in ISO 8601, and `zones` when present. Use `id` unchanged with the product and reviews endpoints.

## Filters and pages

Pass `query` or `category`, not both. `sort` accepts the codes the storefront publishes. `price` accepts a range from a facet url such as `2 - 10`. `brand` is the name as the storefront shows it. `page` holds 48 products; the exact `offset` is honoured and a short page has no next page. Page one is never relabelled.

## Credits

A successful request costs **1 credit**. Errors and challenges cost nothing. The response shows the charge in `meta.credits_charged`.

- **Documentation:** [https://scrappa.co/docs/lidl-api/lidl_search](https://scrappa.co/docs/lidl-api/lidl_search)
- **API group:** Lidl Online Shop API
- **Endpoint:** `GET https://scrappa.co/api/lidl/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 | No | Search words. Use this or category. |
| `category` | string | No | Numeric category facet id. Use this or query. |
| `sort` | string | No | relevancy, price, price-desc, firstOnlineDate-desc, ratingScore-desc, sh_carts-desc or percentageDiscount-desc. |
| `price` | string | No | Price filter from a facet url, for example 2 - 10. |
| `brand` | string | No | Brand as the storefront shows it. |
| `page` | integer | No | Result page of 48 products. |

## Example request

```bash
#!/bin/bash

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

## Example response

```json
{
    "success": true,
    "query": "bohrer",
    "numFound": 179,
    "items": [
        {
            "id": "100407156",
            "name": "Akku-Bohrschrauber PARKSIDE",
            "brand": {
                "name": "PARKSIDE",
                "id": null,
                "url": null,
                "logo": null
            },
            "price": 29.99,
            "original_price": 49.99,
            "discount_percent": 40,
            "currency": "EUR",
            "rating": 4.5,
            "review_count": 120,
            "online_available": true,
            "image": "https://cdn.lidl.de/image.jpg",
            "offer_from": "2026-11-01T00:00:00Z",
            "offer_to": null
        }
    ],
    "page": 1,
    "has_more": true,
    "meta": {
        "endpoint_family": "lidl-search",
        "billable": true,
        "credits_charged": 1
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A query parameter is missing, unknown or conflicting. Unknown parameters are rejected, never ignored. Non-billable. |
| 503 | Upstream Unavailable | The storefront could not be reached, answered with a challenge, or changed its JSON shape (`upstream_blocked`, `upstream_unavailable`, `parser_drift`). Retryable and 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)
