Skip to documentation
Browse documentation

Search Products

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.

Capability ID lidl.products.search
Cost 1 credit per request
Maximum runtime 30 seconds
View raw Get an API key

POST /execute Shared execution endpoint

Input parameters

FieldTypeRequiredDescription
country string Optional
fetchsize integer Optional
offset integer Optional
query string Required

Response

Successful output is returned in results[0].data. Raw platform output is intentionally open-ended and may evolve with the upstream source.

Illustrative sample The full redacted fixture is shown in the response panel.

Illustrative output fields

Derived from the sample above for orientation only. These observed fields are not a fixed response schema.

PathObserved typeExample
country string GB
fetchsize integer 24
items array 3 items
items array 3 items
numFound integer 20
offset integer 0
query string chocolate
raw object 22 fields
raw.advisors array 0 items
raw.assortment string GB
raw.breadcrumbs array 1 items
raw.details object 0 fields
raw.engine string ldt-searcher
raw.facets array 3 items
raw.fetchsize integer 24
raw.id string aaeae7a8-96a6-468a-8730-9fffee7cf149
raw.items array 3 items
raw.locale string en_GB
raw.masterQuery string chocolate
raw.maxfetchsize integer 1000
raw.numFound integer 20
raw.offset integer 0
raw.q string chocolate
raw.resultType string search
raw.sort object 4 fields
raw.sorts array 3 items
raw.teasers object 0 fields
raw.type string search
raw.version string v2.0.0
raw.xPayload object 1 fields

Execution behavior

A 200 response completed inline. A 202 response was queued; poll GET /jobs/:id until the job reaches completed or failed.

Resources