lidl.com APIlidl.com ↗
Search Lidl US grocery products, browse category trees, and retrieve current prices, promotions, and stock status by store location via 3 REST endpoints.
curl -X GET 'https://api.parse.bot/scraper/8abf1be8-d321-484a-bcef-d3cf82535ebd/search_products' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for grocery products by keyword at a specific Lidl store. Returns paginated results with prices, stock status, promotions, and aisle/section information.
| Param | Type | Description |
|---|---|---|
| limit | integer | Maximum number of results to return per page. |
| queryrequired | string | Search term for products (e.g. 'milk', 'bread', 'chicken'). |
| offset | integer | Number of results to skip for pagination. |
| store_id | string | Lidl store ID in format US followed by digits (e.g. 'US01053' for Culpeper VA). Determines product availability and pricing. |
{
"type": "object",
"fields": {
"results": "array of product objects with id, name, description, price, currency, base_price_text, stock_status, image_url, categories, promotion, aisle, section",
"total_results": "integer"
},
"sample": {
"results": [
{
"id": "1067979",
"name": "2% reduced fat milk",
"aisle": 1,
"price": 1.88,
"section": "Chiller",
"currency": "USD",
"image_url": "https://production-endpoint.azureedge.net/images/A14KQNQ9DLGMEPA3DTMMIRJ7ADNMURHEE1N6ENPL60O7GD9G60/0a61e8c4-9324-49de-b5ae-cb9da5abc285/PIM_ImageComingSoon.png_500x500.jpg",
"promotion": null,
"categories": [
"OCI1000079",
"OCI2000110"
],
"description": "half gallon",
"stock_status": "INSTOCK",
"base_price_text": "2.94 ¢ per fl.oz."
}
],
"total_results": 288
}
}About the lidl.com API
The Lidl US API covers 3 endpoints for searching and browsing grocery products across Lidl store locations. The search_products endpoint accepts a keyword and optional store ID to return paginated product results including current price, stock status, promotion details, aisle categories, and a base price text field. Two additional endpoints expose the full category tree and per-category product listings, making it straightforward to build store-aware grocery tools.
What the API Returns
All three endpoints return product objects sharing a consistent shape: id, name, description, price, currency, base_price_text, stock_status, image_url, categories, and promotion fields. The search_products endpoint accepts a query string (e.g. 'milk', 'chicken') alongside an optional store_id in the format US followed by digits (e.g. US01053 for the Culpeper, VA location). Pagination is controlled with limit and offset parameters, and the response includes a total_results integer so you can implement accurate page counts.
Browsing by Category
The get_categories endpoint returns a hierarchical category tree scoped to a given store, with each category object exposing a code, name, parents array, and product_count. Those code values (e.g. OCI2000110 for milk & creamers, OCI1000079 for dairy) feed directly into get_category_products, which returns the same paginated product listing format as search_products but filtered to a specific department or sub-department.
Store-Level Scoping
The store_id parameter appears on all three endpoints and is what makes results location-specific. Lidl's US inventory, promotions, and stock status can vary by store, so passing a store_id ensures the price and availability data matches what a shopper would actually see at that location. Omitting it returns a default catalog view. The base_price_text field in product responses often conveys unit pricing (e.g. per lb or per oz), which is useful for unit-price comparison logic.
- Build a grocery price tracker that monitors Lidl product prices and promotion changes by store over time.
- Populate a meal planning app with current in-stock Lidl products filtered by category using get_category_products.
- Compare Lidl shelf prices against other retailers using the price and base_price_text fields from search_products.
- Create a store-specific shopping list tool that validates stock_status before surfacing items to users.
- Index Lidl's full product catalog by walking the category tree from get_categories and paginating through each category.
- Alert shoppers when a searched product has an active promotion by monitoring the promotions field in search_products results.
- Build a dietary filter layer on top of category browsing by combining category codes with product name and description fields.
| 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.