lidl.de APIlidl.de ↗
Access Lidl Germany's weekly promotional flyers, category bestsellers, and keyword product search. Returns flyer PDFs, validity dates, and product IDs.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/e7ac1918-457d-4cbb-bac9-8d60f9756571/get_weekly_promotions' \ -H 'X-API-Key: $PARSE_API_KEY'
Retrieve the latest weekly promotional flyer (Aktionsprospekt) with detailed product items listed in the flyer. Returns flyer metadata and a list of products with IDs, titles, URLs, and page numbers.
No input parameters required.
{
"type": "object",
"fields": {
"name": "string, flyer name (e.g. 'Aktionsprospekt')",
"items": "array of product objects with id, title, url, and page number",
"title": "string, date range title",
"pdf_url": "string, URL to download the flyer PDF",
"flyer_id": "string, unique identifier for the flyer",
"valid_to": "string, ISO date when flyer expires",
"valid_from": "string, ISO date when flyer becomes valid"
},
"sample": {
"data": {
"name": "Aktionsprospekt",
"items": [
{
"id": "100399662",
"url": "https://www.lidl.de/p/grillmeister-pizzastein/p100399662",
"page": 1,
"title": "GRILLMEISTER Pizzastein"
}
],
"title": "04.05.2026 – 09.05.2026",
"pdf_url": "https://object.storage.eu01.onstackit.cloud/leaflets/pdfs/019df89d-8d00-7c48-89a0-61e7e2403e91/Aktionsprospekt-04-05-2026-09-05-2026-00.pdf",
"flyer_id": "019df89d-8d00-7c48-89a0-61e7e2403e91",
"valid_to": "2026-05-09",
"valid_from": "2026-05-04"
},
"status": "success"
}
}About the lidl.de API
The Lidl Germany API exposes 4 endpoints covering weekly promotional flyers (Aktionsprospekte) and category product listings from lidl.de. Use get_weekly_promotions to retrieve the current flyer with per-item page numbers, PDF download URL, and validity dates, or call get_all_flyers to get metadata across all currently active flyer publications including thumbnail URLs and file sizes.
Weekly Flyers
get_weekly_promotions returns the active Aktionsprospekt with fields including flyer_id, valid_from, valid_to, pdf_url, and a title string representing the date-range label. The items array lists each product in the flyer with its id, title, url, and the page number it appears on — useful for mapping flyer page positions to specific products.
get_all_flyers returns a count and a flyers array where each object includes id, name, category, subcategory, valid_from, valid_to, pdf_url, file_size_bytes, thumbnail_url, and page count. This gives a full snapshot of all publications Lidl Germany currently has live.
Category Products and Search
get_category_products accepts a category_key parameter with four accepted values: essen-trinken, baby-kind-spielzeug, mode-accessoires, and wein-spirituosen. It returns bestseller product IDs for that category — the response includes count, category, and an items array of objects each with an id field. Note that prices and descriptions are not returned by this endpoint.
search_products takes a free-text query and maps it to one of the supported categories using keyword matching (for example, baby, spiel, or kind resolve to baby-kind-spielzeug). When no keyword maps to a category, the response includes a note field listing available categories and returns a null category value. Both product endpoints return IDs only, so a product detail lookup is not included in the current spec.
- Aggregate Lidl Germany's weekly deal flyer into a price-tracking or deal-alert application using
valid_from,valid_to, andpdf_url. - Build a flyer browsing UI that links flyer page numbers to specific products using the
pagefield in theget_weekly_promotionsitems array. - Download and archive all active Lidl flyer PDFs by iterating the
flyersarray fromget_all_flyersand storingpdf_urlandfile_size_bytes. - Populate a category browser for Lidl Germany's online shop by querying
get_category_productsacross the four supported category keys. - Map user search input to Lidl product categories using
search_productsto return relevant bestseller product IDs. - Generate flyer thumbnails or preview grids using the
thumbnail_urlfield returned byget_all_flyers. - Track flyer publication cadence by recording
valid_fromandvalid_toacross successive calls toget_all_flyers.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Lidl Germany have an official developer API?+
What does get_weekly_promotions return beyond the PDF link?+
flyer_id, name, title (a human-readable date-range label), valid_from, valid_to, and pdf_url. The items array includes each product listed in the flyer with its id, title, url, and the page number it appears on in the flyer. Prices and stock status are not included.Does the API return product prices or descriptions?+
get_category_products and search_products return product IDs only — the items array contains id strings without price, description, image, or availability fields. The flyer endpoints include product titles and URLs but not structured pricing data. You can fork this API on Parse and revise it to add a product detail endpoint that returns pricing and description fields.How does keyword search work in search_products, and what happens when no keyword matches?+
query parameter is matched against a fixed keyword list: terms like baby, spiel, or kind resolve to baby-kind-spielzeug; essen, trink, milch, or lebensmittel resolve to essen-trinken; wein, spirit, bier, or alkohol resolve to wein-spirituosen. If no keyword matches, category is returned as null and a note field lists the available category keys.