Skip to documentation
Browse documentation

List Promotions

List paginated discounted online products from Lidl Germany or France, including current and deleted prices from the public sale assortments.

Capability ID lidl.promotions.list
Cost 1 credit per request
Maximum runtime 30 seconds
View raw

POST /execute Shared execution endpoint

Input parameters

country string optional

GB item-level Lidl Plus offers require an authenticated consumer session and are not part of this public capability.

Example DE
Available values DEFR
fetchsize integer optional

No additional description is provided for this parameter.

Example 5
offset integer optional

No additional description is provided for this parameter.

Example 0

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 DE
fetchsize integer 5
items array 3 items
items array 3 items
numFound integer 4660
offset integer 0

Execution behavior

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