Lidl API: prijzen en aanbiedingen van lidl.nl als JSON

Met deze API lees je lidl.nl uit als JSON, precies zoals een klant zonder account de site te zien krijgt: de webshop met prijzen in euro, de aanbiedingen met de periode waarin ze in de winkel liggen, en de Lidl Plus-prijs in een eigen veld. Een koppeling met de Lidl Plus-app, met je kassabonnen of met een leveranciersportaal is het niet; je krijgt alleen wat Lidl openbaar op de site zet, gezien vanaf de kant van de klant. Standaard antwoordt de Duitse site (lidl.de); met `"country": "nl"` in de body lees je lidl.nl.

Werkend voorbeeld

Drie rijen uit de eerste pagina van 27 oktober 2026, met drie soorten prijs. Chocomel heeft helemaal geen gewone prijs: alleen 2,19 'met Lidl Plus' (-27%), alleen in de winkel van 30/10 tot en met 05/11. `price` is dan null, en dat gold voor 17 van de 178 aanbiedingen. De steelstofzuiger kost 139 euro, en de doorgestreepte 169 is de eerdere prijs bij Lidl zelf (`previous_price`). Bij de Oral-B is de doorgestreepte 39,99 een adviesprijs van de fabrikant (`recommended_retail_price`), dus die -53% zegt niets over wat het artikel eerder bij Lidl kostte. Wie alleen over `price` middelt, mist de Lidl Plus-artikelen; wie `price` en `member_price` door elkaar gebruikt, mengt app-prijzen met winkelprijzen.

curl -X POST https://api.reefapi.com/lidl/v1/deals \
  -H "x-api-key: JOUW_SLEUTEL" \
  -H "content-type: application/json" \
  -d '{"country": "nl", "limit": 60}'

{
  "ok": true,
  "data": {
    "results": [
      ...
      {
        "product_id": "100389544",
        "title": "ORAL-B Pro Vitality Elektrische tandenborstel, Black",
        "brand": "ORAL-B",
        "currency": "EUR",
        "price": 18.99,
        "price_before_discount": 39.99,
        "price_before_discount_type": "recommended_retail_price",
        "discount_percent": 53,
        "availability": "available_online",
        "availability_text": "Ook in de winkel 24/10 - 30/10"
      },
      ...
      {
        "product_id": "100412129",
        "title": "SILVERCREST® Accu-steelstofzuiger 24 V",
        "price": 139,
        "price_before_discount": 169,
        "price_before_discount_type": "previous_price",
        "discount_label": "€ 30 goedkoper",
        "price_valid_until": "2026-11-01T22:59:59Z",
        "rating": 5,
        "review_count": 2
      },
      ...
      {
        "product_id": "11303602",
        "title": "Chocomel",
        "price": null,
        "member_price": 2.19,
        "member_program": "Lidl Plus",
        "member_price_label": "met Lidl Plus",
        "member_discount_label": "-27%",
        "available_online": false,
        "availability": "in_store_only",
        "store_offers": [
          {
            "label": "Alleen in de winkel vanaf 30/10 - 05/11",
            "type": "IN_STORE_FROM_FUTURE_DATE_RANGE",
            "valid_from": "2026-10-29T23:00:00Z",
            "valid_until": "2026-11-05T22:59:59Z"
          }
        ],
        "category": "Food"
      },
      ...
    ],
    "count": 60,
    "total_results": 178,
    "country": "nl",
    "language": "nl",
    "currency": "EUR",
    "web_shop": true
  },
  "meta": { "record_count": 60, "pagination": { "page": 1, "has_more": true, "page_size": 60, "total": 178 }, "cache_hit": false, "mode": "live" }
}

Grenzen en eerlijke kanttekeningen

• Lidl biedt deze toegang niet zelf aan. Het is een onafhankelijke dienst, zonder contract of partnerschap met Lidl.
• Bekend probleem: zet `limit` niet hoger dan 60. Op 27 oktober 2026 gaf `deals` op lidl.nl met `limit: 100` per pagina maar 60 rijen, terwijl pagina 2 bij rij 101 begon en `has_more` al op false stond: 58 van de 178 aanbiedingen kwamen nooit langs. Met `limit: 60` kwamen alle 178 binnen in drie pagina's. De standaard is 36.
• Een voorraadaantal publiceert Lidl niet. Je krijgt een status (online leverbaar, binnenkort online, alleen in de winkel); `max_order_quantity` (10 bij de steelstofzuiger) is een bestelgrens, geen voorraad.
• Reviewteksten zijn er niet: alleen het gemiddelde, het aantal beoordelingen en hoe vaak het product is aanbevolen.
• Artikelen die alleen in de winkel liggen hebben geen beoordeling en vaak ook geen EAN.
• Elke aanroep kost 1 credit, ook product/detail.
• Je ziet altijd de stand van lidl.nl op het moment van de aanroep: een aanbieding die vanavond afloopt, staat morgen ook niet meer in je antwoord.