# Lidl Product

## Overview

| Property | Value |
|----------|-------|
| **Status** | active |
| **Method** | `GET` |
| **Endpoint** | `/v2/lidl/product` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/lidl-product |

## Description

Lidl Product API: fetch full product page data from a Lidl URL or ERP id. Returns pricing, images, description, availability and category via Nuxt SSR parsing.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/lidl/product' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Perceuse PSBM 750 B3 (100397447) on lidl.fr

```json
{
  "url": "https://www.lidl.fr/p/parkside-perceuse-a-percussion-psbm-750-b3-10-nm-750-w/p100397447",
  "brand": "PARKSIDE®",
  "price": 17.99,
  "title": "PARKSIDE® Perceuse à percussion PSBM 750 B3, 10 Nm, 750 W",
  "images": [
    "https://www.lidl.fr/assets/gcp8943e01124db4b4b8be1424510edcc10.jpg"
  ],
  "locale": "fr-fr",
  "rating": 4.2,
  "category": "Assortiment/Bricoler/Atelier/.../Perceuses à percussion",
  "currency": "EUR",
  "in_stock": true,
  "image_url": "https://www.lidl.fr/assets/gcp8943e01124db4b4b8be1424510edcc10.jpg",
  "old_price": 31.99,
  "product_id": "100397447",
  "description": "<h3>PARKSIDE® Perceuse à percussion PSBM 750 B3, 10 Nm, 750 W</h3>",
  "availability": "in_stock",
  "review_count": 145,
  "availability_text": "Disponible à la livraison",
  "discount_percentage": 43
}
```

## Documentation

## Overview
The **Lidl Product API** returns full product page data from Lidl online shops. Pass a **product URL** or **ERP id**, optionally with **`region`**, and receive structured JSON with pricing, images, specs, availability, and category.

Piloterr parses the Nuxt 3 SSR payload (`#__NUXT_DATA__`) from the HTML, no browser rendering required.

Use [Lidl Search](https://www.piloterr.com/library/lidl-search) to discover listings, then [Lidl Product](https://www.piloterr.com/library/lidl-product) for the full record.

## Supported regions
27 countries. Default: `fr` → `www.lidl.fr`.

| `region` | Domain | Locale | Currency | Aliases |
|---|---|---|---|---|
| `fr` | lidl.fr | fr-fr | EUR | `fr-fr` |
| `de` | lidl.de | de-de | EUR | `de-de` |
| `es` | lidl.es | es-es | EUR | `es-es` |
| `it` | lidl.it | it-it | EUR | `it-it` |
| `pl` | lidl.pl | pl-pl | PLN | `pl-pl` |
| `nl` | lidl.nl | nl-nl | EUR | `nl-nl` |
| `be` / `fr-be` / `nl-be` | lidl.be | fr-be / nl-be | EUR | - |
| `gb` | lidl.co.uk | en-gb | GBP | `uk`, `en-gb` |
| `ch` / `at` / `dk` / `se` / `fi` / … | see docs | - |: | 27 countries total |

ERP-only queries (`100397447`, `p100397447`) resolve via internal search on the target shop.

## Quickstart
```
GET https://api.piloterr.com/v2/lidl/product?query=100397447
GET https://api.piloterr.com/v2/lidl/product?query=100397447&region=fr
GET https://api.piloterr.com/v2/lidl/product?query=https://www.lidl.fr/p/parkside-perceuse-a-percussion-psbm-750-b3-10-nm-750-w/p100397447
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Product URL or ERP id (`100397447`, `p100397447`) |
| `region` | string | no | Country when `query` is ERP id only (default: `fr`) |
| `return_page_source` | boolean | no | Raw HTML as `{"result": "..."}` (default: `false`) |

## Response fields
| Field | Type | Description |
|---|---|---|
| `product_id` | string | ERP number |
| `title` | string | Product title |
| `url` | string | Canonical product URL |
| `description` | string \| null | Long HTML description |
| `image_url` | string \| null | Main image |
| `images` | string[] \| null | Ordered gallery |
| `price` | number \| null | Current price (may be absent on some shops) |
| `old_price` | number \| null | Strikethrough price |
| `discount_percentage` | number \| null | Discount in % |
| `currency` | string | ISO currency |
| `brand` | string \| null | Brand name |
| `rating` | number \| null | Average rating |
| `review_count` | integer \| null | Review count |
| `category` | string \| null | Lidl category path |
| `in_stock` | boolean \| null | Online availability |
| `availability` | string \| null | `in_stock` / `out_of_stock` |
| `availability_text` | string \| null | Display badge text |
| `locale` | string | Shop locale |

## Lidl workflow
1. [Lidl Search](https://www.piloterr.com/library/lidl-search): discover listings
2. [Lidl Product](https://www.piloterr.com/library/lidl-product): full PDP JSON (this endpoint)

## Error codes
| Code | Meaning |
|---|---|
| `400` | Missing or invalid `query` / `region` |
| `404` | Unparsable or missing product page |
| `500` | Network or parsing error |

## Notes
- `price` may be `null` on some regional shops (product metadata still returned).
- Belgium URLs may include `/p/fr-BE/` or `/p/nl-BE/`: locale is inferred from the path.
- Costs **1 credit** per call (HTTP crawler).

## Main use cases
- **PDP enrichment**: description, gallery, category, availability
- **Promo tracking**: `old_price`, `discount_percentage`
- **Multi-country catalogs**: same ERP across Lidl regional shops