# List Promotions

List paginated discounted online products from Lidl Germany or France, including current and deleted prices from the public sale assortments.

- Platform: [Lidl](https://docs.upscrape.com/docs/platforms/lidl)
- Capability ID: `lidl.promotions.list`
- Cost: 1 credit per request
- Maximum runtime: 30 seconds
- Execute endpoint: `POST https://data.upscrape.com/execute`

## Request

Use the exact public capability ID in the shared execute envelope.

```bash
curl --request POST \
  --url https://data.upscrape.com/execute \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --header "Prefer: wait=30" \
  --data '{
  "input": {
    "country": "DE",
    "fetchsize": 5,
    "offset": 0
  },
  "capability": "lidl.promotions.list"
}'
```

## Input

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `country` | `string` | No | GB item-level Lidl Plus offers require an authenticated consumer session and are not part of this public capability. |
| `fetchsize` | `integer` | No |  |
| `offset` | `integer` | No |  |

### Example input

```json
{
  "country": "DE",
  "fetchsize": 5,
  "offset": 0
}
```

## Response

Successful output is returned in `results[0].data`. Raw platform output is intentionally open-ended and may evolve with the upstream source.

### Illustrative sample output

This redacted fixture is an example, not a fixed response schema.

```json
{
  "country": "DE",
  "fetchsize": 5,
  "items": [
    {
      "brand": "SILVERCREST®",
      "code": "100408447",
      "currency": "EUR",
      "deleted_price": 14.99,
      "gridbox": {
        "action": "UPDATE",
        "country": "DE",
        "data": {
          "productId": 100408447,
          "energyLabels": [],
          "isLidlGiftCard": false,
          "keyfacts": {
            "analyticsCategory": "Kategorien/Haushalt & Küche/Kochgeschirr/Aluminiumpfannen",
            "fullTitle": "SILVERCREST® Aluminium-Pfanne, Ø 24 cm",
            "moreDetails": "Weitere Produktdetails",
            "supplementalDescription": "<!-- Supplemental description (203014 - Aluminiumpfannen)--> <p><strong>Durchmesser</strong>: &Oslash; 24 cm<br /> <strong>Beschichtung</strong>: Antihaftbeschichtung<br /> <strong>Geeignet f&uuml;r</strong>: alle Herdarten</p>",
            "title": "Aluminium-Pfanne, Ø 24 cm",
            "wonCategoryPrimary": "Bedürfniswelten/Küche & Haushalt/Kochen & Backen",
            "wonCategoryPrimaryPath": "0/11/1112"
          },
          "category": "Kategorien/Haushalt & Küche/Kochgeschirr/Aluminiumpfannen",
          "lidlPlus": [],
          "havingPrice": true,
          "ians": [
            "516813"
          ],
          "canonicalPath": "/p/silvercrest-aluminium-pfanne-o-24-cm/p100408447",
          "timezoneId": "Europe/Berlin",
          "awards": [],
          "ribbons": [
            {
              "icon": "star-10",
              "text": "Top Kundenbewertungen",
              "theme": "top-rated",
              "type": "TOP_RATED"
            }
          ],
          "regionsPrices": {},
          "image": "https://www.lidl.de/assets/gcp912780ce601e4c1bb885007aa2542918.jpg",
          "storeStartDate": 1787176800,
          "preventSelling": false,
          "renderedTs": 1787291130,
          "dealOfDay": {
            "active": false
          },
          "image_V1": {
            "accessibility": "Mintgrüne Bratpfanne mit gesprenkelter Antihaftbeschichtung, mit Farboptionen.",
            "image": "https://www.lidl.de/assets/gcp912780ce601e4c1bb885007aa2542918.jpg"
          },
          "ratings": {
            "average": 5,
            "count": 24,
            "recommendedNo": 0,
            "recommendedYes": 24,
            "sizePercentage": 0,
            "text": "Top Kundenbewertungen",
            "topRated": true
          },
          "cutoutimageV2": [],
          "havingThreesixty": false,
          "gs1Attributes": [],
          "imageList_V1": [
            {
              "accessibility": "Mintgrüne Bratpfanne mit gesprenkelter Antihaftbeschichtung, mit Farboptionen.",
              "image": "https://www.lidl.de/assets/gcp912780ce601e4c1bb885007aa2542918.jpg"
            },
            {
              "accessibility": "Mintgrüne Antihaft-Bratpfanne mit schwarzer, gesprenkelter Innenseite",
              "image": "https://www.lidl.de/assets/gcp5a4fad1bf1534b3086bad7829763784e.jpg"
            },
            {
              "accessibility": "Mintgrüne Bratpfanne mit geschnittenem Gemüse darin.",
              "image": "https://www.lidl.de/assets/gcpb151864e2c5d4495b84e9086c2ef07fc.jpg"
            }
          ],
          "erpNumber": "100408447",
          "designTheme": "default",
          "imageList": [
            "https://www.lidl.de/assets/gcp912780ce601e4c1bb885007aa2542918.jpg",
            "https://www.lidl.de/assets/gcp5a4fad1bf1534b3086bad7829763784e.jpg",
            "https://www.lidl.de/assets/gcpb151864e2c5d4495b84e9086c2ef07fc.jpg"
          ],
          "zones": {
            "DE1": {
              "currentPrice": {
                "currencyCode": "EUR",
                "currencyCodeSecond": "",
                "currencySymbol": "€",
                "currencySymbolSecond": "",
                "discount": {
                  "bargainHintEnabled": true,
                  "bargainHintText": "Mega Schnäppchen",
                  "deletedPrice": 14.99,
                  "discountHasStar": false,
                  "fromNormalPriceForLidlPlus": false,
                  "fromRecommendedPrice": false,
                  "hideBargainHint": false,
                  "percentageDiscount": 33,
                  "showDiscount": true,
                  "showFrom": false,
                  "showPercentage": true,
                  "showUpTo": false
                },
                "endDate": "2026-08-23T21:59:59Z",
                "endDateExclusive": "2026-08-23T22:00Z",
                "hasStar": true,
                "hasVat": true,
                "hasZeroVat": false,
                "oldPrice": 14.99,
                "packaging": {},
                "price": 9.99,
                "showEndDate": false,
                "specialTaxes": [],
                "startDate": "2026-08-06T22:00Z",
                "tax": "19",
                "variantsHaveDifferentPrices": false
              },
              "dealOfDay": {
                "active": false
              },
              "deliveryCharges": {
                "absoluteDeliveryCharge": 0,
                "additiveDeliveryCharge": 0,
                "defaultDeliveryCharge": 5.95,
                "freeDelivery": false,
                "homeDeliveryCharge": 5.95,
                "parcelLockerDeliveryCharge": 5.95,
                "parcelShopDeliveryCharge": 5.95,
                "someFreeOfDeliveryCharges": false,
                "someHaveDifferentAbsoluteCharges": false,
                "someHaveDifferentAdditionalCharges": false,
                "someHaveDifferentAdditiveCharges": false,
                "someHaveDifferentDefaultCharges": false,
                "someHaveDifferentHomeDeliveryCharges": false,
                "someHaveDifferentParcelLockerCharges": false,
                "someHaveDifferentParcelLockerLidlParkingLotLidlPlusDeliveryCharge": false,
                "someHaveDifferentParcelShopCharges": false,
                "someHaveDifferentZoneSurcharges": false,
                "someHaveDifferentparcelLockerLidlParkingLotDeliveryCharges": false
              },
              "id": "DE1",
              "isDefault": true,
              "margin": {},
              "statusDisplayStorefront": "DISPLAY",
              "statusOnlineActual": "ONLINE",
              "zone": "DE National"
            }
          },
          "flashSales": false,
          "price": {
            "currencyCode": "EUR",
            "currencyCodeSecond": "",
            "currencySymbol": "€",
            "currencySymbolSecond": "",
            "discount": {
              "bargainHintEnabled": true,
              "bargainHintText": "Mega Schnäppchen",
              "deletedPrice": 14.99,
              "discountHasStar": false,
              "fromNormalPriceForLidlPlus": false,
              "fromRecommendedPrice": false,
              "hideBargainHint": false,
              "percentageDiscount": 33,
              "showDiscount": true,
              "showFrom": false,
              "showPercentage": true,
              "showUpTo": false
            },
            "endDate": "2026-08-23T21:59:59Z",
            "endDateExclusive": "2026-08-23T22:00Z",
            "hasStar": true,
            "hasVat": true,
            "hasZeroVat": false,
            "oldPrice": 14.99,
            "packaging": {},
            "price": 9.99,
            "showEndDate": false,
            "specialTaxes": [],
            "startDate": "2026-08-06T22:00Z",
            "tax": "19",
            "variantsHaveDifferentPrices": false
          },
          "storeEndDate": 1787435999,
          "highlightedSeals": 0,
          "ageRestriction": false,
          "brand": {
            "id": "SILV",
            "logo": "https://www.lidl.de/assets/gcpbf79ffdf385e472b898f12072d9e605c.png",
            "name": "SILVERCREST®",
            "showBrand": true,
            "url": "https://www.lidl.de/c/silvercrest/s10007139"
          },
          "store": true,
          "quickAddToCart": false,
          "fullTitle": "SILVERCREST® Aluminium-Pfanne, Ø 24 cm",
          "productOrigin": "progress_event",
          "seals": [],
          "isUsedProduct": false,
          "categorySecondaryPath": "0/20/2030/203014",
          "multipack": false,
          "stockAvailability": {
            "availabilityIndicator": 3,
            "backInStockNotification": true,
            "backInStockNotificationSoldOut": true,
            "badgeInfo": {
              "badges": [
                {
                  "text": "auch in der Filiale 20.08. - 22.08.",
                  "type": "ALSO_IN_STORE_PAST_DATE_RANGE"
                },
                {
                  "text": "lieferbar",
                  "type": "AVAILABLE_ONLINE"
                }
              ]
            },
            "badgeInfoV2": [
              {
                "badges": [
                  {
                    "text": "auch in der Filiale 20.08. - 22.08.",
                    "type": "ALSO_IN_STORE_PAST_DATE_RANGE"
                  },
                  {
                    "text": "lieferbar",
                    "type": "AVAILABLE_ONLINE"
                  }
                ],
                "validFrom": 1787176800,
                "validUntil": 1787435999
              },
              {
                "badges": [
                  {
                    "text": "lieferbar",
                    "type": "AVAILABLE_ONLINE"
                  }
                ]
              }
            ],
            "minOrderableQuantity": 1,
            "onlineAvailable": true
          },
          "displayFreeDelivery": false,
          "productType": "HEAD_VARIANT",
          "disclaimers": [
            {
              "id": "code_100408447_c97b5d6f",
              "type": "CODE",
              "value": "Basic"
            },
            {
              "id": "code_100408447_7cb3e4e5",
              "type": "CODE",
              "value": "Price"
            }
          ],
          "title": "Aluminium-Pfanne, Ø 24 cm",
          "canonicalUrl": "/p/silvercrest-aluminium-pfanne-o-24-cm/p100408447",
          "havingVideos": false,
          "online": true
        },
        "eventType": "GRIDBOX",
        "id": "100408447",
        "language": "de",
        "meta": {
          "campaignPaths": [
            [
              {
                "hiddenCategory": false,
                "id": "10100536",
                "name": "Küche, ab 20.8.",
                "url": "/c/kueche-ab-20-8/a10100536"
              }
            ]
          ],
          "categoryPaths": [
            [
              {
                "hiddenCategory": false,
                "id": "10006086",
                "name": "Haushalt & Küche",
                "url": "/h/haushalt-kueche/h10006086"
              },
              {
                "hiddenCategory": false,
                "id": "10006217",
                "name": "Kochen & Backen",
                "url": "/h/kochen-backen/h10006217"
              },
              {
                "hiddenCategory": false,
                "id": "10017000",
                "name": "Pfannen",
                "url": "/h/pfannen/h10017000"
              }
            ]
          ],
          "fullTitle": "SILVERCREST® Aluminium-Pfanne, Ø 24 cm",
          "gs1": {
            "segment": {
              "code": "73000000",
              "family": {
                "clazz": {
                  "brick": {
                    "attributeGS1": [],
                    "code": "10002144",
                    "label": "Töpfe für Bratgeschirr / Pfannen / Woks / Kokotten"
                  },
                  "code": "73040400",
                  "label": "Kochgeschirr / Backformen"
                },
                "code": "73040000",
                "label": "Küchengeräte"
              },
              "label": "Küchengeräte und Geschirr"
            }
          },
          "preview": false,
          "sapProductCategory": {
            "code": "203014",
            "name": "Aluminiumpfannen",
            "pathCode": "0/20/2030/203014",
            "pathName": "Kategorien/Haushalt & Küche/Kochgeschirr/Aluminiumpfannen"
          },
          "shopCategories": {
            "shopCategory": [
              {
                "code": "203014",
                "name": "Aluminiumpfannen",
                "parent": "2030",
                "superCategories": {
                  "category": [
                    {
                      "code": "2030",
                      "name": "Kochgeschirr",
                      "parent": "20"
                    },
                    {
                      "code": "20",
                      "name": "Haushalt & Küche",
                      "parent": "0"
                    },
                    {
                      "code": "0",
                      "name": "Kategorien",
                      "parent": ""
                    }
                  ]
                }
              }
            ]
          },
          "wonCategoryBreadcrumbs": [
            [
              {
                "hiddenCategory": false,
                "id": "10067764",
                "name": "Küche & Haushalt",
                "url": "/c/kueche-haushalt/s10067764"
              },
              {
                "hiddenCategory": false,
                "id": "10067523",
                "name": "Kochen & Backen",
                "url": "/h/kochen-backen/h10067523"
              }
            ],
            [
              {
                "hiddenCategory": false,
                "id": "10067764",
                "name": "Küche & Haushalt",
                "url": "/c/kueche-haushalt/s10067764"
              },
              {
                "hiddenCategory": false,
                "id": "10067523",
                "name": "Kochen & Backen",
                "url": "/h/kochen-backen/h10067523"
              },
              {
                "hiddenCategory": false,
                "id": "10017000",
                "name": "Pfannen",
                "url": "/h/pfannen/h10017000"
              }
            ]
          ],
          "worldOfNeeds": [
            {
              "code": "1112",
              "isMain": true,
              "name": "Kochen & Backen",
              "parent": "11",
              "superCategories": [
                {
                  "code": "11",
                  "name": "Küche & Haushalt",
                  "parent": "0"
                },
                {
                  "code": "0",
                  "name": "Bedürfniswelten",
                  "parent": ""
                }
              ]
            }
          ]
        },
        "productId": 100408447,
        "sequence": 1787291130751886
      },
      "image": "https://www.lidl.de/assets/gcp912780ce601e4c1bb885007aa2542918.jpg",
      "price": 9.99,
      "product_type": "HEAD_VARIANT",
      "rating_average": 5,
      "rating_count": 24,
      "title": "SILVERCREST® Aluminium-Pfanne, Ø 24 cm",
      "url": "https://www.lidl.de/p/silvercrest-aluminium-pfanne-o-24-cm/p100408447"
    },
    {
      "brand": "LUPILU®",
      "code": "100392542",
      "currency": "EUR",
      "deleted_price": 13.99,
      "gridbox": {
        "action": "UPDATE",
        "country": "DE",
        "data": {
          "productId": 100392542,
          "energyLabels": [],
          "isLidlGiftCard": false,
          "keyfacts": {
            "analyticsCategory": "Kategorien/Mode/Kindermode/Kleinkinder Mädchen/Stiefel",
            "fullTitle": "LUPILU® Kleinkinder Regenstiefel mit Licht und Warmfutter",
            "moreDetails": "Weitere Produktdetails",
            "supplementalDescription": "<p><b>Farbe:</b> rosa, t&uuml;rkis<br /> <b>Merkmal:</b>&nbsp;mit coolem Blink-Effekt<br /> <b>Besonderheit:</b> wasserdicht</p>",
            "title": "Kleinkinder Regenstiefel mit Licht und Warmfutter",
            "wonCategoryPrimary": "Bedürfniswelten/Baby, Kind & Spielware/Kinderbekleidung 2-8 Jahre",
            "wonCategoryPrimaryPath": "0/16/1612"
          },
          "category": "Kategorien/Mode/Kindermode/Kleinkinder Mädchen/Stiefel",
          "lidlPlus": [],
          "havingPrice": true,
          "ians": [
            "478746"
          ],
          "canonicalPath": "/p/lupilu-kleinkinder-regenstiefel-mit-licht-und-warmfutter/p100392542",
          "timezoneId": "Europe/Berlin",
          "awards": [],
          "ribbons": [],
          "regionsPrices": {},
          "image": "https://www.lidl.de/assets/gcp858e890c87a24d649a915502ba1458f0.jpg",
          "salesAttributes": {
            "template": [
              {
                "date": [],
                "flag": [],
                "id": 132001,
                "label": [
                  {
                    "key": "campaignTags",
                    "value": "testesast2"
                  }
                ],
                "list": [],
                "name": "campaignTags_DE",
                "text": [],
                "version": "1"
              },
              {
                "date": [],
                "flag": [],
                "id": 132001,
                "label": [
                  {
                    "key": "campaignTags",
                    "value": "2616fruehling"
                  }
                ],
                "list": [],
                "name": "campaignTags_DE",
                "text": [],
                "version": "1"
              }
            ]
          },
          "preventSelling": false,
          "renderedTs": 1786785932,
          "dealOfDay": {
            "active": false
          },
          "image_V1": {
            "accessibility": "",
            "image": "https://www.lidl.de/assets/gcp858e890c87a24d649a915502ba1458f0.jpg"
          },
          "ratings": {
            "average": 4.1,
            "count": 14,
            "recommendedNo": 3,
            "recommendedYes": 10,
            "sizePercentage": 71,
            "sizeType": "FITS_PERFECTLY",
            "topRated": false
          },
          "cutoutimageV2": [],
          "havingThreesixty": false,
          "gs1Attributes": [],
          "imageList_V1": [
            {
              "accessibility": "",
              "image": "https://www.lidl.de/assets/gcp858e890c87a24d649a915502ba1458f0.jpg"
            },
            {
              "accessibility": "Rosa Kindergummistiefel mit grauem Tupfenbündchen und Hasenmotiv",
              "image": "https://www.lidl.de/assets/gcpba6e48f2d6034b768b2b9da0885d79c4.jpg"
            },
            {
              "accessibility": "",
              "image": "https://www.lidl.de/assets/gcpa491103550d24797940a2f21c93743d0.jpg"
            }
          ],
          "erpNumber": "100392542",
          "designTheme": "default",
          "imageList": [
            "https://www.lidl.de/assets/gcp858e890c87a24d649a915502ba1458f0.jpg",
            "https://www.lidl.de/assets/gcpba6e48f2d6034b768b2b9da0885d79c4.jpg",
            "https://www.lidl.de/assets/gcpa491103550d24797940a2f21c93743d0.jpg"
          ],
          "zones": {
            "DE1": {
              "currentPrice": {
                "currencyCode": "EUR",
                "currencyCodeSecond": "",
                "currencySymbol": "€",
                "currencySymbolSecond": "",
                "discount": {
                  "bargainHintEnabled": false,
                  "bargainHintText": "Mega Schnäppchen",
                  "deletedPrice": 13.99,
                  "discountHasStar": false,
                  "fromNormalPriceForLidlPlus": false,
                  "fromRecommendedPrice": false,
                  "hideBargainHint": false,
                  "percentageDiscount": 7,
                  "showDiscount": true,
                  "showFrom": false,
                  "showPercentage": false,
                  "showUpTo": false
                },
                "hasStar": true,
                "hasVat": true,
                "hasZeroVat": false,
                "oldPrice": 13.99,
                "packaging": {},
                "price": 12.99,
                "showEndDate": false,
                "specialTaxes": [],
                "startDate": "2026-08-13T14:26:10.329Z",
                "tax": "19",
                "variantsHaveDifferentPrices": false
              },
              "dealOfDay": {
                "active": false
              },
              "deliveryCharges": {
                "absoluteDeliveryCharge": 0,
                "additiveDeliveryCharge": 0,
                "defaultDeliveryCharge": 5.95,
                "freeDelivery": false,
                "homeDeliveryCharge": 5.95,
                "parcelLockerDeliveryCharge": 5.95,
                "parcelShopDeliveryCharge": 5.95,
                "someFreeOfDeliveryCharges": false,
                "someHaveDifferentAbsoluteCharges": false,
                "someHaveDifferentAdditionalCharges": false,
                "someHaveDifferentAdditiveCharges": false,
                "someHaveDifferentDefaultCharges": false,
                "someHaveDifferentHomeDeliveryCharges": false,
                "someHaveDifferentParcelLockerCharges": false,
                "someHaveDifferentParcelLockerLidlParkingLotLidlPlusDeliveryCharge": false,
                "someHaveDifferentParcelShopCharges": false,
                "someHaveDifferentZoneSurcharges": false,
                "someHaveDifferentparcelLockerLidlParkingLotDeliveryCharges": false
              },
              "id": "DE1",
              "isDefault": true,
              "margin": {},
              "statusDisplayStorefront": "DISPLAY",
              "statusOnlineActual": "ONLINE",
              "zone": "DE National"
            }
          },
          "flashSales": false,
          "price": {
            "currencyCode": "EUR",
            "currencyCodeSecond": "",
            "currencySymbol": "€",
            "currencySymbolSecond": "",
            "discount": {
              "bargainHintEnabled": false,
              "bargainHintText": "Mega Schnäppchen",
              "deletedPrice": 13.99,
              "discountHasStar": false,
              "fromNormalPriceForLidlPlus": false,
              "fromRecommendedPrice": false,
              "hideBargainHint": false,
              "percentageDiscount": 7,
              "showDiscount": true,
              "showFrom": false,
              "showPercentage": false,
              "showUpTo": false
            },
            "hasStar": true,
            "hasVat": true,
            "hasZeroVat": false,
            "oldPrice": 13.99,
            "packaging": {},
            "price": 12.99,
            "showEndDate": false,
            "specialTaxes": [],
            "startDate": "2026-08-13T14:26:10.329Z",
            "tax": "19",
            "variantsHaveDifferentPrices": false
          },
          "storeEndDate": 1756591199,
          "highlightedSeals": 0,
          "ageRestriction": false,
          "brand": {
            "id": "LUPI",
            "logo": "https://www.lidl.de/assets/a7a71c1385d69152f9617b791958f715.jpeg",
            "name": "LUPILU®",
            "showBrand": true,
            "url": "https://www.lidl.de/c/lupilu/s10007130"
          },
          "store": false,
          "quickAddToCart": false,
          "fullTitle": "LUPILU® Kleinkinder Regenstiefel mit Licht und Warmfutter",
          "productOrigin": "progress_event",
          "seals": [],
          "isUsedProduct": false,
          "categorySecondaryPath": "0/46/4613/461317/46131737",
          "multipack": false,
          "stockAvailability": {
            "availabilityIndicator": 3,
            "backInStockNotification": true,
            "backInStockNotificationSoldOut": true,
            "badgeInfo": {
              "badges": [
                {
                  "text": "lieferbar",
                  "type": "AVAILABLE_ONLINE"
                }
              ]
            },
            "badgeInfoV2": [
              {
                "badges": [
                  {
                    "text": "lieferbar",
                    "type": "AVAILABLE_ONLINE"
                  }
                ],
                "validFrom": 1756072800,
                "validUntil": 1756591199
              },
              {
                "badges": [
                  {
                    "text": "lieferbar",
                    "type": "AVAILABLE_ONLINE"
                  }
                ]
              }
            ],
            "minOrderableQuantity": 1,
            "onlineAvailable": true
          },
          "displayFreeDelivery": false,
          "productType": "HEAD_VARIANT",
          "disclaimers": [
            {
              "id": "code_100392542_ad44177d",
              "type": "CODE",
              "value": "Basic"
            },
            {
              "id": "code_100392542_7da6c864",
              "type": "CODE",
              "value": "Price"
            }
          ],
          "title": "Kleinkinder Regenstiefel mit Licht und Warmfutter",
          "canonicalUrl": "/p/lupilu-kleinkinder-regenstiefel-mit-licht-und-warmfutter/p100392542",
          "havingVideos": false,
          "online": true
        },
        "eventType": "GRIDBOX",
        "id": "100392542",
        "language": "de",
        "meta": {
          "campaignPaths": [
            [
              {
                "hiddenCategory": false,
                "id": "10013436",
                "name": "Passend für jedes Wetter",
                "url": "/c/passend-fuer-jedes-wetter/a10013436"
              }
            ],
            [
              {
                "hiddenCategory": false,
                "id": "10100959",
                "name": "Matsch & Buddel, ab 24.8.",
                "url": "/c/matsch-buddel-ab-24-8/a10100959"
              }
            ]
          ],
          "categoryPaths": [
            [
              {
                "hiddenCategory": false,
                "id": "10005518",
                "name": "Mode",
                "url": "/h/mode/h10005518"
              },
              {
                "hiddenCategory": false,
                "id": "10007082",
                "name": "Kindermode",
                "url": "/h/kindermode/h10007082"
              },
              {
                "hiddenCategory": false,
                "id": "10007099",
                "name": "Schuhe",
                "url": "/h/kinderschuhe/h10007099"
              }
            ]
          ],
          "fullTitle": "LUPILU® Kleinkinder Regenstiefel mit Licht und Warmfutter",
          "gs1": {
            "segment": {
              "code": "63000000",
              "family": {
                "clazz": {
                  "brick": {
                    "attributeGS1": [],
                    "code": "10001076",
                    "label": "Stiefel - universal"
                  },
                  "code": "63010300",
                  "label": "Universalschuhe"
                },
                "code": "63010000",
                "label": "Schuhe"
              },
              "label": "Schuhe"
            }
          },
          "preview": false,
          "sapProductCategory": {
            "code": "46131737",
            "name": "Stiefel",
            "pathCode": "0/46/4613/461317/46131737",
            "pathName": "Kategorien/Mode/Kindermode/Kleinkinder Mädchen/Stiefel"
          },
          "shopCategories": {
            "shopCategory": [
              {
                "code": "46131737",
                "name": "Stiefel",
                "parent": "461317",
                "superCategories": {
                  "category": [
                    {
                      "code": "461317",
                      "name": "Kleinkinder Mädchen",
                      "parent": "4613"
                    },
                    {
                      "code": "4613",
                      "name": "Kindermode",
                      "parent": "46"
                    },
                    {
                      "code": "46",
                      "name": "Mode",
                      "parent": "0"
                    }
                  ]
                }
              }
            ]
          },
          "wonCategoryBreadcrumbs": [
            [
              {
                "hiddenCategory": false,
                "id": "10067767",
                "name": "Baby, Kind & Spielzeug",
                "url": "/c/baby-kind-spielzeug/s10067767"
              },
              {
                "hiddenCategory": false,
                "id": "10067575",
                "name": "Kinderbekleidung 2-8 Jahre",
                "url": "/h/kinderbekleidung-2-8-jahre/h10067575"
              }
            ],
            [
              {
                "hiddenCategory": false,
                "id": "10067767",
                "name": "Baby, Kind & Spielzeug",
                "url": "/c/baby-kind-spielzeug/s10067767"
              },
              {
                "hiddenCategory": false,
                "id": "10067575",
                "name": "Kinderbekleidung 2-8 Jahre",
                "url": "/h/kinderbekleidung-2-8-jahre/h10067575"
              },
              {
                "hiddenCategory": false,
                "id": "10080750",
                "name": "Schuhe für Kinder",
                "url": "/h/schuhe-fuer-kinder/h10080750"
              }
            ]
          ],
          "worldOfNeeds": [
            {
              "code": "1612",
              "isMain": true,
              "name": "Kinderbekleidung 2-8 Jahre",
              "parent": "16",
              "superCategories": [
                {
                  "code": "16",
                  "name": "Baby, Kind & Spielware",
                  "parent": "0"
                },
                {
                  "code": "0",
                  "name": "Bedürfniswelten",
                  "parent": ""
                }
              ]
            }
          ]
        },
        "productId": 100392542,
        "sequence": 1786785932594683
      },
      "image": "https://www.lidl.de/assets/gcp858e890c87a24d649a915502ba1458f0.jpg",
      "price": 12.99,
      "product_type": "HEAD_VARIANT",
      "rating_average": 4.1,
      "rating_count": 14,
      "title": "LUPILU® Kleinkinder Regenstiefel mit Licht und Warmfutter",
      "url": "https://www.lidl.de/p/lupilu-kleinkinder-regenstiefel-mit-licht-und-warmfutter/p100392542"
    },
    {
      "brand": "CRIVIT",
      "code": "100406930",
      "currency": "EUR",
      "deleted_price": 12.99,
      "gridbox": {
        "action": "UPDATE",
        "country": "DE",
        "data": {
          "productId": 100406930,
          "energyLabels": [],
          "isLidlGiftCard": false,
          "keyfacts": {
            "analyticsCategory": "Kategorien/Mode/Damenmode/Damen Sportbekleidung/Sport Hosen",
            "fullTitle": "CRIVIT Regenhose",
            "moreDetails": "Weitere Produktdetails",
            "supplementalDescription": "<p><strong>Farbe:&nbsp;</strong>schwarz<br /> <strong>Merkmal: </strong>atmungsaktiv, wind- und wasserdicht<br /> <strong>Besonderheit:&nbsp;</strong>in sich packbar</p>",
            "title": "Regenhose",
            "wonCategoryPrimary": "Bedürfniswelten/Sport & Freizeit/Camping & Outdoor",
            "wonCategoryPrimaryPath": "0/13/1311"
          },
          "category": "Kategorien/Mode/Damenmode/Damen Sportbekleidung/Sport Hosen",
          "lidlPlus": [],
          "havingPrice": true,
          "ians": [
            "539151"
          ],
          "canonicalPath": "/p/crivit-regenhose/p100406930",
          "timezoneId": "Europe/Berlin",
          "awards": [],
          "ribbons": [],
          "regionsPrices": {},
          "image": "https://www.lidl.de/assets/gcp5f460482e3e244ab90e572abf12dc421.jpg",
          "storeStartDate": 1787522400,
          "preventSelling": false,
          "renderedTs": 1787053869,
          "dealOfDay": {
            "active": false
          },
          "image_V1": {
            "accessibility": "Schwarze Herren-Sporthose",
            "image": "https://www.lidl.de/assets/gcp5f460482e3e244ab90e572abf12dc421.jpg"
          },
          "ratings": {
            "average": 5,
            "count": 1,
            "recommendedNo": 0,
            "recommendedYes": 1,
            "sizePercentage": 0,
            "topRated": false
          },
          "cutoutimageV2": [],
          "havingThreesixty": false,
          "gs1Attributes": [],
          "imageList_V1": [
            {
              "accessibility": "Schwarze Herren-Sporthose",
              "image": "https://www.lidl.de/assets/gcp5f460482e3e244ab90e572abf12dc421.jpg"
            }
          ],
          "erpNumber": "100406930",
          "designTheme": "default",
          "imageList": [
            "https://www.lidl.de/assets/gcp5f460482e3e244ab90e572abf12dc421.jpg"
          ],
          "zones": {
            "DE1": {
              "currentPrice": {
                "currencyCode": "EUR",
                "currencyCodeSecond": "",
                "currencySymbol": "€",
                "currencySymbolSecond": "",
                "discount": {
                  "bargainHintEnabled": true,
                  "bargainHintText": "Mega Schnäppchen",
                  "deletedPrice": 12.99,
                  "discountHasStar": false,
                  "fromNormalPriceForLidlPlus": false,
                  "fromRecommendedPrice": false,
                  "hideBargainHint": false,
                  "percentageDiscount": 23,
                  "showDiscount": true,
                  "showFrom": false,
                  "showPercentage": true,
                  "showUpTo": false
                },
                "endDate": "2026-08-30T21:59:59Z",
                "endDateExclusive": "2026-08-30T22:00Z",
                "hasStar": true,
                "hasVat": true,
                "hasZeroVat": false,
                "oldPrice": 12.99,
                "packaging": {},
                "price": 9.99,
                "showEndDate": false,
                "specialTaxes": [],
                "startDate": "2026-08-13T22:00Z",
                "tax": "19",
                "variantsHaveDifferentPrices": false
              },
              "dealOfDay": {
                "active": false
              },
              "deliveryCharges": {
                "absoluteDeliveryCharge": 0,
                "additiveDeliveryCharge": 0,
                "defaultDeliveryCharge": 5.95,
                "freeDelivery": false,
                "homeDeliveryCharge": 5.95,
                "parcelLockerDeliveryCharge": 5.95,
                "parcelShopDeliveryCharge": 5.95,
                "someFreeOfDeliveryCharges": false,
                "someHaveDifferentAbsoluteCharges": false,
                "someHaveDifferentAdditionalCharges": false,
                "someHaveDifferentAdditiveCharges": false,
                "someHaveDifferentDefaultCharges": false,
                "someHaveDifferentHomeDeliveryCharges": false,
                "someHaveDifferentParcelLockerCharges": false,
                "someHaveDifferentParcelLockerLidlParkingLotLidlPlusDeliveryCharge": false,
                "someHaveDifferentParcelShopCharges": false,
                "someHaveDifferentZoneSurcharges": false,
                "someHaveDifferentparcelLockerLidlParkingLotDeliveryCharges": false
              },
              "id": "DE1",
              "isDefault": true,
              "margin": {},
              "statusDisplayStorefront": "DISPLAY",
              "statusOnlineActual": "ONLINE",
              "zone": "DE National"
            }
          },
          "flashSales": false,
          "price": {
            "currencyCode": "EUR",
            "currencyCodeSecond": "",
            "currencySymbol": "€",
            "currencySymbolSecond": "",
            "discount": {
              "bargainHintEnabled": true,
              "bargainHintText": "Mega Schnäppchen",
              "deletedPrice": 12.99,
              "discountHasStar": false,
              "fromNormalPriceForLidlPlus": false,
              "fromRecommendedPrice": false,
              "hideBargainHint": false,
              "percentageDiscount": 23,
              "showDiscount": true,
              "showFrom": false,
              "showPercentage": true,
              "showUpTo": false
            },
            "endDate": "2026-08-30T21:59:59Z",
            "endDateExclusive": "2026-08-30T22:00Z",
            "hasStar": true,
            "hasVat": true,
            "hasZeroVat": false,
            "oldPrice": 12.99,
            "packaging": {},
            "price": 9.99,
            "showEndDate": false,
            "specialTaxes": [],
            "startDate": "2026-08-13T22:00Z",
            "tax": "19",
            "variantsHaveDifferentPrices": false
          },
          "storeEndDate": 1788040799,
          "highlightedSeals": 0,
          "ageRestriction": false,
          "brand": {
            "id": "CRIV",
            "logo": "https://www.lidl.de/assets/gcp1c00a8130ac24a449bac0cf49ed21ece.png",
            "name": "CRIVIT",
            "showBrand": true,
            "url": "https://www.lidl.de/c/crivit/s10012383"
          },
          "store": false,
          "quickAddToCart": false,
          "fullTitle": "CRIVIT Regenhose",
          "productOrigin": "progress_event",
          "seals": [],
          "isUsedProduct": false,
          "categorySecondaryPath": "0/46/4610/461012/46101211",
          "multipack": false,
          "stockAvailability": {
            "availabilityIndicator": 3,
            "backInStockNotification": true,
            "backInStockNotificationSoldOut": true,
            "badgeInfo": {
              "badges": [
                {
                  "text": "auch in der Filiale von 24.08. - 29.08.",
                  "type": "ALSO_IN_STORE_FROM_FUTURE_DATE_RANGE"
                },
                {
                  "text": "lieferbar",
                  "type": "AVAILABLE_ONLINE"
                }
              ]
            },
            "badgeInfoV2": [
              {
                "badges": [
                  {
                    "text": "auch in der Filiale von 24.08. - 29.08.",
                    "type": "ALSO_IN_STORE_FROM_FUTURE_DATE_RANGE"
                  },
                  {
                    "text": "lieferbar",
                    "type": "AVAILABLE_ONLINE"
                  }
                ],
                "validFrom": 1787522400,
                "validUntil": 1788040799
              },
              {
                "badges": [
                  {
                    "text": "lieferbar",
                    "type": "AVAILABLE_ONLINE"
                  }
                ]
              }
            ],
            "minOrderableQuantity": 1,
            "onlineAvailable": true
          },
          "displayFreeDelivery": false,
          "productType": "HEAD_VARIANT",
          "disclaimers": [
            {
              "id": "code_100406930_f337c57a",
              "type": "CODE",
              "value": "Basic"
            },
            {
              "id": "code_100406930_31775964",
              "type": "CODE",
              "value": "Price"
            }
          ],
          "title": "Regenhose",
          "canonicalUrl": "/p/crivit-regenhose/p100406930",
          "havingVideos": false,
          "online": true
        },
        "eventType": "GRIDBOX",
        "id": "100406930",
        "language": "de",
        "meta": {
          "campaignPaths": [
            [
              {
                "hiddenCategory": false,
                "id": "10077313",
                "name": "Outdoorspaß für Kinder",
                "url": "/c/asc/outdoorspass-fuer-kinder/a10077313"
              }
            ],
            [
              {
                "hiddenCategory": false,
                "id": "10100956",
                "name": "Sport, ab 24.8.",
                "url": "/c/sport-ab-24-8/a10100956"
              }
            ]
          ],
          "categoryPaths": [
            [
              {
                "hiddenCategory": false,
                "id": "10005518",
                "name": "Mode",
                "url": "/h/mode/h10005518"
              },
              {
                "hiddenCategory": false,
                "id": "10005804",
                "name": "Damenmode",
                "url": "/h/damenmode/h10005804"
              },
              {
                "hiddenCategory": false,
                "id": "10007040",
                "name": "Sportmode Damen",
                "url": "/h/damensportmode/h10007040"
              }
            ],
            [
              {
                "hiddenCategory": false,
                "id": "10005518",
                "name": "Mode",
                "url": "/h/mode/h10005518"
              },
              {
                "hiddenCategory": false,
                "id": "10007147",
                "name": "Sportmode",
                "url": "/h/sportmode/h10007147"
              },
              {
                "hiddenCategory": false,
                "id": "10007148",
                "name": "Sportbekleidung",
                "url": "/h/sportbekleidung/h10007148"
              }
            ],
            [
              {
                "hiddenCategory": false,
                "id": "10006690",
                "name": "Sport & Freizeit",
                "url": "/h/sport-freizeit/h10006690"
              },
              {
                "hiddenCategory": false,
                "id": "10006806",
                "name": "Sport",
                "url": "/h/sport/h10006806"
              },
              {
                "hiddenCategory": false,
                "id": "10006892",
                "name": "Fitness Zubehör",
                "url": "/h/fitnessausruestung/h10006892"
              }
            ]
          ],
          "fullTitle": "CRIVIT Regenhose",
          "gs1": {
            "segment": {
              "code": "67000000",
              "family": {
                "clazz": {
                  "brick": {
                    "attributeGS1": [],
                    "code": "10001335",
                    "label": "Hosen (lang / kurz)"
                  },
                  "code": "67010300",
                  "label": "Beinbekleidung"
                },
                "code": "67010000",
                "label": "Bekleidung"
              },
              "label": "Bekleidung"
            }
          },
          "preview": false,
          "sapProductCategory": {
            "code": "46101211",
            "name": "Sport Hosen",
            "pathCode": "0/46/4610/461012/46101211",
            "pathName": "Kategorien/Mode/Damenmode/Damen Sportbekleidung/Sport Hosen"
          },
          "shopCategories": {
            "shopCategory": [
              {
                "code": "46101211",
                "name": "Sport Hosen",
                "parent": "461012",
                "superCategories": {
                  "category": [
                    {
                      "code": "461012",
                      "name": "Damen Sportbekleidung",
                      "parent": "4610"
                    },
                    {
                      "code": "4610",
                      "name": "Damenmode",
                      "parent": "46"
                    },
                    {
                      "code": "46",
                      "name": "Mode",
                      "parent": "0"
                    }
                  ]
                }
              }
            ]
          },
          "wonCategoryBreadcrumbs": [
            [
              {
                "hiddenCategory": false,
                "id": "10067763",
                "name": "Sport & Freizeit",
                "url": "/c/sport-freizeit/s10067763"
              },
              {
                "hiddenCategory": false,
                "id": "10067541",
                "name": "Sportbekleidung",
                "url": "/h/sportbekleidung/h10067541"
              },
              {
                "hiddenCategory": false,
                "id": "10007151",
                "name": "Sporthosen",
                "url": "/h/sporthosen/h10007151"
              }
            ],
            [
              {
                "hiddenCategory": false,
                "id": "10067763",
                "name": "Sport & Freizeit",
                "url": "/c/sport-freizeit/s10067763"
              },
              {
                "hiddenCategory": false,
                "id": "10067542",
                "name": "Camping & Outdoor",
                "url": "/h/camping-outdoor/h10067542"
              }
            ]
          ],
          "worldOfNeeds": [
            {
              "code": "1311",
              "isMain": true,
              "name": "Camping & Outdoor",
              "parent": "13",
              "superCategories": [
                {
                  "code": "13",
                  "name": "Sport & Freizeit",
                  "parent": "0"
                },
                {
                  "code": "0",
                  "name": "Bedürfniswelten",
                  "parent": ""
                }
              ]
            }
          ]
        },
        "productId": 100406930,
        "sequence": 1787053869362418
      },
      "image": "https://www.lidl.de/assets/gcp5f460482e3e244ab90e572abf12dc421.jpg",
      "price": 9.99,
      "product_type": "HEAD_VARIANT",
      "rating_average": 5,
      "rating_count": 1,
      "title": "CRIVIT Regenhose",
      "url": "https://www.lidl.de/p/crivit-regenhose/p100406930"
    }
  ],
  "numFound": 4660,
  "offset": 0
}
```
### Illustrative output fields

Derived from the sample above for orientation only. These fields are not a fixed response schema.

| Path | Observed type | Example |
| --- | --- | --- |
| `country` | `string` | DE |
| `fetchsize` | `integer` | 5 |
| `items` | `array` | 3 items |
| `items` | `array` | 3 items |
| `numFound` | `integer` | 4660 |
| `offset` | `integer` | 0 |

## Execution behavior

A `200` response completed inline. A `202` response was queued; poll `GET /jobs/{id}` until the job reaches `completed` or `failed`. Use an `Idempotency-Key` when retrying must not create a duplicate logical job.

## Related documentation

- [Authentication](https://docs.upscrape.com/docs/api/authentication)
- [Jobs and results](https://docs.upscrape.com/docs/api/jobs)
- [Errors and retries](https://docs.upscrape.com/docs/api/errors)
- [Idempotency](https://docs.upscrape.com/docs/api/idempotency)
