lidl.nl APIlidl.nl ↗
Access Lidl.nl weekly folder offers, product search, detailed product info, and bestsellers via a structured JSON API. Prices, discounts, and availability included.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/657145b6-bbea-4f41-9ddf-df7b392e4ac8/get_weekly_offers' \ -H 'X-API-Key: $PARSE_API_KEY'
Get current weekly discount/offers from the Lidl folder API including validity dates, discount keywords per page, and featured products with prices and discount percentages.
No input parameters required.
{
"type": "object",
"fields": {
"pages": "array of page objects with page_number, keywords, alt_text, and recommended_product_ids",
"end_date": "string - folder end date (YYYY-MM-DD)",
"start_date": "string - folder start date (YYYY-MM-DD)",
"folder_name": "string - folder title/date range",
"offer_end_date": "string - offers end date (YYYY-MM-DD)",
"number_of_pages": "integer - total number of pages in the folder",
"offer_start_date": "string - offers start date (YYYY-MM-DD)",
"featured_products": "array of product objects with product_id, title, brand, price, discount_percentage (present when product IDs are available)"
},
"sample": {
"data": {
"pages": [
{
"alt_text": "Reclame voor diverse Lidl aanbiedingen...",
"keywords": "Woensdag Tefal Wokpan...",
"page_number": 1,
"recommended_product_ids": []
}
],
"end_date": "2026-05-17",
"start_date": "2026-05-07",
"folder_name": "11/05 - 17/05",
"offer_end_date": "2026-05-17",
"number_of_pages": 47,
"offer_start_date": "2026-05-11"
},
"status": "success"
}
}About the lidl.nl API
The Lidl Netherlands API exposes 4 endpoints covering the current weekly discount folder, product search, individual product details, and bestsellers from lidl.nl. The get_weekly_offers endpoint returns the active folder's validity dates, page-by-page keywords, and featured products with prices and discount percentages — letting you integrate Lidl's rotating promotional catalog into any application.
Weekly Folder and Offers
The get_weekly_offers endpoint returns the current Lidl Netherlands discount folder with no required inputs. The response includes start_date, end_date, offer_start_date, offer_end_date, folder_name, and number_of_pages. The pages array gives each page's page_number, keywords, alt_text, and recommended_product_ids. Where product IDs are resolved, a featured_products array is returned containing product_id, title, brand, price, and discount_percentage.
Product Search and Filtering
The search_products endpoint accepts a required query string plus optional filters: category, brand, min_price, max_price, and sort. Sort accepts values including relevancy, price, price-desc, firstOnlineDate-desc, and ratingScore-desc. A limit parameter controls result count. The response includes a products array with per-product product_id, title, brand, price, availability, and rating, along with total_results and a filters_applied object showing which filters were active.
Product Details and Bestsellers
The get_product_details endpoint accepts one or more product IDs as a comma-separated string in product_ids and returns a products array. Each product object includes a nested price object with current, original, currency, and discount_percentage fields, alongside availability and image data. The get_bestsellers endpoint takes an optional limit parameter and returns products sorted by popularity, each with original_price, discount_percentage, availability, and online_available fields — useful for tracking which items are selling well at any given point in time.
- Build a weekly deal tracker that alerts users when new Lidl folder offers go live, using
start_dateandend_datefromget_weekly_offers. - Compare grocery prices across retailers by pulling
priceandoriginal_pricefromget_product_detailsfor specific product IDs. - Filter Lidl's assortment by brand and price range using
search_productswithbrand,min_price, andmax_priceparameters. - Display current bestsellers in a shopping assistant app using
get_bestsellerswithdiscount_percentageandonline_availablefields. - Extract keyword and category signals from folder pages using the
keywordsandalt_textfields in thepagesarray. - Monitor discount depth over time by recording
discount_percentagefrom featured products in each weekly folder cycle.
| 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 Netherlands have an official developer API?+
What does `get_weekly_offers` return beyond folder dates?+
start_date, end_date, and folder_name, it returns a pages array where each entry includes page_number, keywords, alt_text, and recommended_product_ids. When product IDs can be resolved, a featured_products array is also included with title, brand, price, and discount_percentage per product.Can I retrieve product reviews or individual user ratings through these endpoints?+
rating scores per product in search_products and get_product_details, but individual user reviews and review text are not currently exposed. The API covers pricing, availability, discount data, and summary ratings. You can fork it on Parse and revise to add an endpoint that returns review-level detail if that data becomes accessible.Is the `search_products` endpoint limited to a single category at a time?+
category filter accepts a single category name string per request. Multi-category filtering in one call is not currently supported. You can fork the API on Parse and revise it to batch across multiple category queries if your use case requires it.How current is the weekly folder data?+
get_weekly_offers endpoint reflects the folder that is active on lidl.nl at the time of the request. The offer_start_date and offer_end_date fields in the response tell you the exact validity window. Lidl typically rotates folders on a weekly basis, so data freshness is tied to when Lidl publishes a new folder.