Lidl API · Endpoint

Lidl Promotions API

Q: Can my AI agent call it?

Yes, over MCP: the agent finds lidl.promotions.list, checks its price and runs it with the same credits as the REST API.

List the discounted products on Lidl Germany or France, with the sale price and the price before.

1–5 credits per call
Failed calls are free
Updated 6 Oct 2026
lidl.promotions.list

Start free, 100 credits API reference

Response completed

{  "numFound": 4958,  "items": [    {      "title": "LUPILU® Kinder Mütze (blau/Streifen)",      "price": 3.99,      "brand": "LUPILU®",      "code": "100411983003",      "currency": "EUR",      "deleted_price": 6.99,      "ean": "4054599502502",      "product_type": "VARIANT",      "url": "https://www.lidl.de/p/lupilu-kinder-muetze/p100411983003"    },    {      "title": "CRIVIT Kinder Strickmütze (blau/grün)",      "price": 3.99,      "brand": "CRIVIT",      "code": "100412072003",      "currency": "EUR",      "deleted_price": 5.99,      "ean": "4054599502908",      "product_type": "VARIANT",      "url": "https://www.lidl.de/p/crivit-kinder-strickmuetze/p100412072003"    }  ]}

5 rows

#	Title	Brand	Price	Price before	Currency	EAN	Code	Product type	Url
1	LUPILU® Kinder Mütze (blau/Streifen)	LUPILU®	3.99	6.99	EUR	4054599502502	100411983003	VARIANT	https://www.lidl.de/p/lupilu-kinder-muetze/p100411983003
2	CRIVIT Kinder Strickmütze (blau/grün)	CRIVIT	3.99	5.99	EUR	4054599502908	100412072003	VARIANT	https://www.lidl.de/p/crivit-kinder-strickmuetze/p100412072003
3	LUPILU® Kinder-Seamless-Funktionsunterwäsche, 2-teilig (Schwarz…	LUPILU®	9.99	12.99	EUR	4054599427881	100411786003	VARIANT	https://www.lidl.de/p/lupilu-kinder-seamless-funktionsunterwaes…
4	LUPILU® Kleinkinder Schneejacke (lila/navy, 122/128)	LUPILU®	12.99	17.99	EUR	4054599417646	100411803008	VARIANT	https://www.lidl.de/p/lupilu-kleinkinder-schneejacke/p100411803…
5	CRIVIT Kinder Funktionsunterwäsche, 2-teiliges Set (Schwarz, 13…	CRIVIT	9.99	12.99	EUR	4054599427744	100411818001	VARIANT	https://www.lidl.de/p/crivit-kinder-funktionsunterwaesche-2-tei…

Try it live, free

Input

What you send

The input object of the request, with every field the endpoint accepts.

Field	Type	Required	What it does	Example
country	string	no	DE or FR: which Lidl online shop's offers to list.	DE
fetchsize	integer	no	How many offers to return in this call.	5
offset	integer	no	How many offers to skip, to get the next page.	0

Response

Fields it returns

What each record in the response holds, with the values from the sample above.

Field	Type	What it is	Example
items[].title	string	The product name as Lidl shows it.	LUPILU® Kinder Mütze (blau/Streifen)
items[].brand	string	The product's brand.	LUPILU®
items[].price	number	The price, in the currency given.	3.99
items[].deleted_price	number	The price before the offer, in the currency given.	6.99
items[].currency	string	The currency code of the prices.	EUR
items[].ean	string	The product's barcode number.	4054599502502
items[].code	string	Lidl's product code; the product detail endpoint takes it.	100411983003
items[].product_type	string	The kind of listing, such as a store product.	VARIANT
items[].url	string	The page on Lidl's site.	https://www.lidl.de/p/lupilu-kinder-muetze/p100411983003
items	array	The products.	5 records
numFound	integer	How many products Lidl says match.	4958

REST API · MCP server

Call it from your code, or ask your agent

Set UPSCRAPE_API_KEY to your key and copy a working request.

curl --request POST \  --url https://data.upscrape.com/execute \  --header "Authorization: Bearer $UPSCRAPE_API_KEY" \  --header "Content-Type: application/json" \  --header "Prefer: wait=30" \  --data '{  "capability": "lidl.promotions.list",  "input": {    "country": "DE",    "fetchsize": 5,    "offset": 0  }}'

import jsonimport osimport requestspayload = json.loads(r'''{  "capability": "lidl.promotions.list",  "input": {    "country": "DE",    "fetchsize": 5,    "offset": 0  }}''')response = requests.post(    "https://data.upscrape.com/execute",    headers={        "Authorization": f"Bearer {os.environ['UPSCRAPE_API_KEY']}",        "Content-Type": "application/json",        "Prefer": "wait=30",    },    json=payload,)response.raise_for_status()print(json.dumps(response.json(), indent=2))

const response = await fetch("https://data.upscrape.com/execute", {  method: "POST",  headers: {    "Authorization": `Bearer ${process.env.UPSCRAPE_API_KEY}`,    "Content-Type": "application/json",    "Prefer": "wait=30",  },  body: JSON.stringify({  "capability": "lidl.promotions.list",  "input": {    "country": "DE",    "fetchsize": 5,    "offset": 0  }}),});if (!response.ok) {  throw new Error(`Upscrape request failed: ${response.status}`);}console.log(JSON.stringify(await response.json(), null, 2));