# Lidl API

Catalog, category, promotion, product-detail, and store data across Lidl GB, Germany, and France.

- Platform ID: `lidl`
- Capabilities: 6
- Execute endpoint: `POST https://data.upscrape.com/execute`



## Capabilities

### [List categories](https://docs.upscrape.com/docs/platforms/lidl/lidl.categories.list)

- Capability ID: `lidl.categories.list`
- Cost: 1 credit per request

List Lidl's localized top-level online category taxonomy for GB, DE, or FR, including product counts and actionable first-party category API URLs.
### [List category products](https://docs.upscrape.com/docs/platforms/lidl/lidl.category.products.list)

- Capability ID: `lidl.category.products.list`
- Cost: 1–5 credits per request

List a paginated Lidl category from a public category URL or a URL returned by lidl.categories.list, with normalized products and subcategories.
### [Get product detail](https://docs.upscrape.com/docs/platforms/lidl/lidl.product.detail.get)

- Capability ID: `lidl.product.detail.get`
- Cost: 1 credit per request

Get product detail
### [Search products](https://docs.upscrape.com/docs/platforms/lidl/lidl.products.search)

- Capability ID: `lidl.products.search`
- Cost: 1–5 credits per request

Search Lidl's online assortment by keyword across GB, DE, and FR storefronts. Returns products with title, brand, price, ratings, images, PDP URL, and EAN when available.
### [List promotions](https://docs.upscrape.com/docs/platforms/lidl/lidl.promotions.list)

- Capability ID: `lidl.promotions.list`
- Cost: 1–5 credits per request

List paginated discounted online products from Lidl Germany or France, including current and deleted prices from the public sale assortments.
### [List stores](https://docs.upscrape.com/docs/platforms/lidl/lidl.stores.list)

- Capability ID: `lidl.stores.list`
- Cost: 1 credit per request

Find Lidl stores in GB and Germany by city URL, or France through its public store API with optional nearby coordinates.

## Common uses

- Price and promotion monitoring across Lidl Germany and France
- Private-label assortment and competitive product research
- Share-of-search and retail media analysis for Lidl categories
- Store footprint, service, and opening-hours analysis
- Availability tracking for Lidl's online non-food and food range

## Integration contract

All capabilities use the shared `POST /execute` envelope. A `200` response completed inline; a `202` response must be polled through `GET /jobs/{id}`.

See [authentication](https://docs.upscrape.com/docs/api/authentication), [jobs and results](https://docs.upscrape.com/docs/api/jobs), and [errors and retries](https://docs.upscrape.com/docs/api/errors).