Lidl API reference
Get Lidl's online products, prices, categories, offers and stores as clean JSON, for Lidl GB, Germany and France. Search by keyword, browse a category or read one product page.
The Lidl API has 6 endpoints, called the same way: POST /execute with the endpoint ID as capability and its fields as input, or pin Lidl in the MCP server and call each one as a tool. The data comes back as JSON in results[0].data, with what the call cost in billing.credits_charged.
The inputs you send most are url and country. Prices run from 1–5 credits to 1–5 credits per call, and a failed call costs nothing.
Endpoints
Open an endpoint for its input, the fields it returns and the request in cURL, Python and Node.js.
| Endpoint | What it returns | Price |
|---|---|---|
lidl.products.search |
Search Lidl's online range by keyword in the UK, Germany or France. | 1–5 credits |
lidl.product.detail.get |
Get one product from its Lidl page: price, brand, rating, variants with their EANs and delivery charges. | 1 credit |
lidl.category.products.list |
List the products in a Lidl category, page by page, with prices and the category's subcategories. | 1–5 credits |
lidl.promotions.list |
List the discounted products on Lidl Germany or France, with the sale price and the price before. | 1–5 credits |
lidl.categories.list |
Get Lidl's top online categories for a country, with product counts and the links to browse them. | 1 credit |
lidl.stores.list |
Find Lidl stores in a UK or German city, or near a point in France. | 1 credit |
What to know
- Lidl's online shops Products and prices come from Lidl's online shops in the UK, Germany and France, which can differ from a store's shelf.
- Prices in local currency Every product carries its price and currency: pounds for GB, euros for Germany and France.
- Offers for Germany and France The offers endpoint covers Lidl Germany and France. UK offers in the Lidl Plus app need a signed-in shopper, so they are not part of it.
- Pages by offset Lists return how many products were found. Raise the offset by the page size to read the next page.
Something missing or unclear? Ask the team that builds the Lidl endpoints.