API Lidl Search

OverviewLink to Overview

The Lidl Search API returns product listings from Lidl online shops (www.lidl.*). Pass a keyword or a full search URL, optionally with region, and receive structured JSON with prices, ratings, brand, locale, currency, and pagination.

Piloterr fetches the SSR HTML and parses the embedded Nuxt 3 payload (#__NUXT_DATA__) — no browser rendering required.

Use each result url or product_id with Lidl Product for full PDP data.

Supported regionsLink to Supported regions

27 countries. Default: fr → www.lidl.fr.

When query is a full Lidl URL, domain and locale are detected automatically (region is ignored).

QuickstartLink to Quickstart

GET https://api.piloterr.com/v2/lidl/search?query=perceuse
GET https://api.piloterr.com/v2/lidl/search?query=perceuse&region=fr
GET https://api.piloterr.com/v2/lidl/search?query=bohrer&region=de
GET https://api.piloterr.com/v2/lidl/search?query=https://www.lidl.de/q/search?q=bohrer
GET https://api.piloterr.com/v2/lidl/search?query=perceuse&page=2

ParametersLink to Parameters

Response — each listing (results[])Link to Response — each listing (results[])

Response — paginationLink to Response — pagination

Lidl paginates by offset (48 items per page): page 2 → offset=48.

Lidl workflowLink to Lidl workflow

1. Lidl Search — discover listings (this endpoint)
2. Lidl Product — full PDP JSON

Error codesLink to Error codes

NotesLink to Notes

• Some shops may return price: null for certain products (assortment still returned).
• Costs 1 credit per call (HTTP crawler).

Main use casesLink to Main use cases

• Price monitoring — track Lidl promotions across European shops
• Catalog discovery — harvest ERP ids and URLs at scale
• Cross-border retail intel — compare pricing by country