| Get the current price, struck-through normal price, unit price, Lidl Plus app price, discount, stock, rating, category, images and product link for every Lidl product, filter by category, brand, price or offers, and output only the prices that changed since your last run. |
milch, kaffee or parkside. Leave empty to scrape the whole catalog of each country.
## `maxResults` (type: `integer`):
Maximum products to save from each country. Use 0 for no limit (a full catalog is a few hundred to about 13,000 products). In incremental mode this limits how many changed products one run outputs per country; the rest follow in the next runs.
## `category` (type: `string`):
Only return products from this category, in the site's language, such as Essen & Trinken on lidl.de or Food & Drink on lidl.co.uk. A main category or one level below works by name; use a path like Essen & Trinken/Wein, Bier & Spirituosen to go deeper. Unknown names are reported in the log with the main categories of that site.
## `brands` (type: `array`):
Only return products from these brands, such as PARKSIDE or SILVERCREST. Several brands are combined with OR.
## `minPrice` (type: `number`):
Only return products at or above this price, in the country's currency.
## `maxPrice` (type: `number`):
Only return products at or below this price, in the country's currency.
## `onlyOffers` (type: `boolean`):
Only return products with a current discount (a struck-through normal price or recommended retail price).
## `inStockOnly` (type: `boolean`):
Leave out products flagged as sold out online.
## `newOnly` (type: `boolean`):
Only return products the site marks as new. Sites that don't flag new products (lidl.com in the US) are skipped when this is on.
## `assortment` (type: `string`):
Keep only products sold in Lidl stores (now or in an announced in-store week), or only products orderable in the online shop. Most country sites outside DE, FR, PL, ES, NL, BE, CZ and SK list store products only.
## `sortBy` (type: `string`):
Order in which products are read. It decides which products you get when Max products cuts the list short.
## `language` (type: `string`):
Language of names, categories and descriptions for multilingual sites: Belgium (Dutch or French), Switzerland (German, French or Italian) and Cyprus (English or Greek). Other countries always use their own language.
## `compact` (type: `boolean`):
Keep only the shopping essentials: country, product ID, name, brand, price, normal price, unit price, currency, offer flag, discount, Lidl Plus price, stock, image and product link. Same number of rows, same price.
## `incrementalMode` (type: `boolean`):
Read the whole selection and output only products that are NEW, UPDATED (price, offer, stock or unit price changed) or REAPPEARED since the previous run with the same state key. With an empty search keyword, products that disappeared can also be reported as EXPIRED. State is kept per country.
## `stateKey` (type: `string`):
Name of the saved state to compare against, such as lidl-de-tracker. Use a different key for each monitor. Leave empty to derive one from your search and filters.
## `emitUnchanged` (type: `boolean`):
Also output products that did not change, with changeType UNCHANGED.
## `emitExpired` (type: `boolean`):
Output products that were in the previous run but are gone now, with changeType EXPIRED. Only works when the search keyword is empty.
## `proxyConfiguration` (type: `object`):
Optional. The actor works without a proxy and switches to Apify Proxy by itself if Lidl starts refusing requests.
## Actor input object example
```json
{
"countries": [
"DE"
],
"query": "milch",
"maxResults": 50,
"onlyOffers": false,
"inStockOnly": false,
"newOnly": false,
"assortment": "all",
"sortBy": "relevance",
"language": "default",
"compact": false,
"incrementalMode": false,
"emitUnchanged": false,
"emitExpired": false,
"proxyConfiguration": {
"useApifyProxy": false
}
}
```
# Actor output Schema
## `dataset` (type: `string`):
No description
# API
You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.
## JavaScript example
```javascript
import { ApifyClient } from 'apify-client';
// Initialize the ApifyClient with your Apify API token
// Replace the '