Lidl 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.
What is the Lidl 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.
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'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace lidl-nl-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
from parse_apis.lidl_netherlands_api import Lidl, Sort, ProductSummary, Product
lidl = Lidl()
# Get current weekly folder
folder = lidl.weeklyfolders.current()
print(folder.folder_name, folder.start_date, folder.end_date)
for page in folder.pages[:3]:
print(page.page_number, page.keywords[:50])
# Search products with discount sort
for product in lidl.productsummaries.search(query="koffie", sort=Sort.DISCOUNT):
print(product.title, product.brand, product.price, product.discount_percentage)
# Get bestsellers
for item in lidl.productsummaries.bestsellers():
print(item.title, item.price, item.online_available)
# Get full product details by ID
for detail in lidl.products.get(product_ids="100391089"):
print(detail.full_title, detail.price.current, detail.price.currency)
print(detail.ratings.average, detail.ratings.count)
print(detail.availability.online_available)
for badge in detail.availability.badges:
print(badge.text, badge.type)
Get the current weekly discount folder from Lidl Netherlands including validity dates, page keywords, and featured products with pricing. The folder rotates weekly; start_date and end_date bound the folder validity window while offer_start_date and offer_end_date bound when the offers are active. Pages contain keywords summarising their content and optional recommended_product_ids.
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"
},
"sample": {
"data": {
"pages": [
{
"alt_text": "Lidl folderpagina met diverse kortingen...",
"keywords": "Groente &Amp Maandag Zaterdag...",
"page_number": 1,
"recommended_product_ids": []
}
],
"end_date": "2026-06-14",
"start_date": "2026-06-04",
"folder_name": "08/06 - 14/06",
"offer_end_date": "2026-06-14",
"number_of_pages": 52,
"offer_start_date": "2026-06-08"
},
"status": "success"
}
}About the Lidl API
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.
The Lidl API is a managed, monitored endpoint for lidl.nl — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when lidl.nl changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official lidl.nl API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- 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 | 100 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.