Lidl Search
Lidl Search API: search product listings by keyword or URL across Lidl online shops in 27 countries. Parses Nuxt SSR payload from HTML; returns prices, ratings, brand and pagination.
Credit cost: 1 credit per call
ApiKeyAuthx-api-key<token>Your API key. Include it in the x-api-key header for every request.
query*stringSearch keyword or full Lidl search URL.
Examples:
perceusehttps://www.lidl.de/q/search?q=bohrerUse Lidl Product on any result url or product_id for full PDP data.
region?stringTarget country when query is a keyword (default: fr).
Examples: de, pl, gb, nl-be, fr-be
Ignored when query is a full Lidl URL.
page?number1-based page number (default: 1). Lidl paginates by offset (48 items per page).
1 <= value <= 500return_page_source?booleanWhen true, return the raw HTML page source as {"result": "..."} instead of structured JSON. Defaults to false.
fields?stringComma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).
is_async?booleanRun the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.
falsesoft_fail?booleanReturn HTTP 200 even when the request fails; the error is in the error field of the body.
falseSuccessful response
application/json- response
results?array<>pagination?curl -X GET 'https://api.piloterr.com/v2/lidl/search?query=string'{ "results": [ { "url": "https://www.lidl.fr/p/parkside-set-perceuse-a-percussion-psbm-750-c3/p100400894", "brand": "PARKSIDE®", "price": 20, "title": "PARKSIDE® Set perceuse à percussion PSBM 750 C3", "locale": "fr-fr", "rating": 4, "currency": "EUR", "image_url": "https://www.lidl.fr/assets/gcp941ea783e919400f859ed3e1193f144f.jpg", "old_price": 51.99, "product_id": "100400894", "review_count": 26, "discount_percentage": 61 } ], "pagination": { "next": "https://www.lidl.fr/q/search?q=perceuse&offset=48&fetchsize=48", "page": 1, "per_page": 48, "total_pages": 4, "total_results": 147 }}