# Lidl (Netherlands) — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Browse Lidl Netherlands weekly leaflet offers, search the online assortment, fetch detailed product information by ERP/product IDs, and retrieve current bestsellers with pricing and availability.

**Category:** E-commerce | **Website:** [lidl.nl/](https://lidl.nl/) | **Docs:** [parse.bot/marketplace/af97fc9d-411e-4a0c-8125-8f036a1bd37a/lidl-nl-api](https://parse.bot/marketplace/af97fc9d-411e-4a0c-8125-8f036a1bd37a/lidl-nl-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-lidl-nl-api-af97fc9d/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_bestsellers

Get best-selling products from the Lidl Netherlands online shop sorted by popularity. Returns product summaries with pricing, discount percentages, availability badges, and customer ratings. The recommendation engine determines the ranking.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of products to return (positive integer) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-lidl-nl-api-af97fc9d/get_bestsellers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>"}'
```

### get_product_details

Retrieve full product details for one or more Lidl Netherlands products by their ERP product IDs. Returns structured pricing (current/original/discount), availability with badges, ratings with recommendation counts, image lists, and canonical product URLs. Accepts a comma-separated list for batch lookups.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `product_ids` | string | Yes | Comma-separated product ID(s) to look up (e.g. '100391089' or '100391089,100395394') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-lidl-nl-api-af97fc9d/get_product_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product_ids":"<string>"}'
```

### get_weekly_offers

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.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-lidl-nl-api-af97fc9d/get_weekly_offers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_products

Full-text search over Lidl Netherlands online product catalog. Returns results with pricing, availability, ratings, and discount information. Supports filtering by category, brand, and price range. Sort controls result ordering. The total_results field reflects the server-side match count before limit is applied.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `brand` | string | No | Filter by brand name |
| `category` | string | No | Filter by category name |
| `limit` | integer | No | Maximum number of results to return (positive integer) |
| `max_price` | number | No | Maximum price filter in euros |
| `min_price` | number | No | Minimum price filter in euros |
| `query` | string | Yes | Search keyword (e.g. 'koffie', 'stofzuiger') |
| `sort` | string | No | Sort order for results |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-lidl-nl-api-af97fc9d/search_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"brand":"<string>","category":"<string>","limit":"<integer>","max_price":"<number>","min_price":"<number>","query":"<string>","sort":"<string>"}'
```