# 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–5 credits 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 $UPSCRAPE_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. Allowed values: `DE`, `FR`. Default: `DE`. | | `fetchsize` | `integer` | No | Number of results per page. From 1 to 100. Default: `24`. | | `offset` | `integer` | No | Zero-based number of results to skip. At least 0. Default: `0`. | ### 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 example shows one response. Values and optional fields vary with the data available. ```json { "country": "DE", "fetchsize": 5, "items": [ { "brand": "LUPILU®", "code": "100410967", "currency": "EUR", "deleted_price": 9.99, "gridbox": { "action": "UPDATE", "country": "DE", "data": { "productId": 100410967, "energyLabels": [], "isLidlGiftCard": false, "keyfacts": { "analyticsCategory": "Kategorien/Mode/Kindermode/Kleinkinder Mädchen/Kleider", "fullTitle": "LUPILU® Kinder Sweatkleid", "moreDetails": "Weitere Produktdetails", "supplementalDescription": "

Style: Frozen; Stitch
Merkmal: Bündchen am Ärmel
Besonderheit: Tüllrock mit Glitzereffekt

", "title": "Kinder Sweatkleid", "wonCategoryPrimary": "Bedürfniswelten/Baby, Kind & Spielware/Kinderbekleidung 2-8 Jahre", "wonCategoryPrimaryPath": "0/16/1612" }, "category": "Kategorien/Mode/Kindermode/Kleinkinder Mädchen/Kleider", "lidlPlus": [], "guaranteeLabels": [], "havingPrice": true, "ians": [ "523130" ], "canonicalPath": "/p/lupilu-kinder-sweatkleid/p100410967", "timezoneId": "Europe/Berlin", "awards": [], "ribbons": [], "regionsPrices": {}, "image": "https://www.lidl.de/assets/gcp638d1e367bba4d84ab09b7d1f6df0fdb.jpg", "storeStartDate": 1790805600, "preventSelling": false, "renderedTs": 1790244395, "dealOfDay": { "active": false }, "image_V1": { "accessibility": "Zwei langärmelige Kinderkleider, eines cremefarben mit Stitch und Angel, eines blau mit Elsa.", "image": "https://www.lidl.de/assets/gcp638d1e367bba4d84ab09b7d1f6df0fdb.jpg" }, "cutoutimageV2": [], "havingThreesixty": false, "gs1Attributes": [], "imageList_V1": [ { "accessibility": "Zwei langärmelige Kinderkleider, eines cremefarben mit Stitch und Angel, eines blau mit Elsa.", "image": "https://www.lidl.de/assets/gcp638d1e367bba4d84ab09b7d1f6df0fdb.jpg" }, { "accessibility": "Weißes Kinderkleid mit rosa Tüllrock und Stitch- und Angel-Aufdruck.", "image": "https://www.lidl.de/assets/gcp78041550d2c146f398096da278bae533.jpg" }, { "accessibility": "Mädchen in cremefarbenem Sweatshirt und rosa Tüllrock mit glitzernden Blumen.", "image": "https://www.lidl.de/assets/gcp6c2c0afb8e3542cb8a2c07ec02f61e51.jpg" } ], "erpNumber": "100410967", "designTheme": "default", "imageList": [ "https://www.lidl.de/assets/gcp638d1e367bba4d84ab09b7d1f6df0fdb.jpg", "https://www.lidl.de/assets/gcp78041550d2c146f398096da278bae533.jpg", "https://www.lidl.de/assets/gcp6c2c0afb8e3542cb8a2c07ec02f61e51.jpg" ], "zones": { "DE1": { "currentPrice": { "currencyCode": "EUR", "currencyCodeSecond": "", "currencySymbol": "€", "currencySymbolSecond": "", "discount": { "absoluteDiscount": 5, "bargainHintEnabled": true, "bargainHintText": "Mega Schnäppchen", "deletedPrice": 9.99, "discountHasStar": false, "fromNormalPriceForLidlPlus": false, "fromRecommendedPrice": false, "hideBargainHint": false, "percentageDiscount": 50, "showDiscount": true, "showFrom": false, "showPercentage": true, "showUpTo": false }, "endDate": "2026-10-04T21:59:59Z", "endDateExclusive": "2026-10-04T22:00Z", "hasStar": true, "hasVat": true, "hasZeroVat": false, "oldPrice": 9.99, "packaging": {}, "price": 4.99, "showEndDate": false, "specialTaxes": [], "startDate": "2026-09-17T22:00Z", "superscript": "", "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" } }, "hasColors": true, "flashSales": false, "price": { "currencyCode": "EUR", "currencyCodeSecond": "", "currencySymbol": "€", "currencySymbolSecond": "", "discount": { "absoluteDiscount": 5, "bargainHintEnabled": true, "bargainHintText": "Mega Schnäppchen", "deletedPrice": 9.99, "discountHasStar": false, "fromNormalPriceForLidlPlus": false, "fromRecommendedPrice": false, "hideBargainHint": false, "percentageDiscount": 50, "showDiscount": true, "showFrom": false, "showPercentage": true, "showUpTo": false }, "endDate": "2026-10-04T21:59:59Z", "endDateExclusive": "2026-10-04T22:00Z", "hasStar": true, "hasVat": true, "hasZeroVat": false, "oldPrice": 9.99, "packaging": {}, "price": 4.99, "showEndDate": false, "specialTaxes": [], "startDate": "2026-09-17T22:00Z", "superscript": "", "tax": "19", "variantsHaveDifferentPrices": false }, "storeEndDate": 1790978399, "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® Kinder Sweatkleid", "productOrigin": "progress_event", "seals": [], "isUsedProduct": false, "categorySecondaryPath": "0/46/4613/461317/46131721", "multipack": false, "stockAvailability": { "availabilityIndicator": 3, "backInStockNotification": true, "backInStockNotificationSoldOut": true, "badgeInfo": { "badges": [ { "text": "auch in der Filiale von 01.10. - 02.10.", "type": "ALSO_IN_STORE_FROM_FUTURE_DATE_RANGE" }, { "text": "lieferbar", "type": "AVAILABLE_ONLINE" } ] }, "badgeInfoV2": [ { "badges": [ { "text": "auch in der Filiale von 01.10. - 02.10.", "type": "ALSO_IN_STORE_FROM_FUTURE_DATE_RANGE" }, { "text": "lieferbar", "type": "AVAILABLE_ONLINE" } ], "validFrom": 1790805600, "validUntil": 1790978399 }, { "badges": [ { "text": "lieferbar", "type": "AVAILABLE_ONLINE" } ] } ], "minOrderableQuantity": 1, "onlineAvailable": true }, "displayFreeDelivery": false, "productType": "HEAD_VARIANT", "disclaimers": [ { "id": "code_100410967_9f7801f0", "type": "CODE", "value": "Basic" }, { "id": "code_100410967_1c1ab207", "type": "CODE", "value": "Price" } ], "title": "Kinder Sweatkleid", "canonicalUrl": "/p/lupilu-kinder-sweatkleid/p100410967", "havingVideos": false, "online": true }, "eventType": "GRIDBOX", "id": "100410967", "language": "de", "meta": { "campaignPaths": [ [ { "hiddenCategory": false, "id": "10101940", "name": "Disney, ab 1.10.", "url": "/c/disney-ab-1-10/a10101940" } ] ], "categoryPaths": [], "fullTitle": "LUPILU® Kinder Sweatkleid", "gs1": { "segment": { "code": "67000000", "family": { "clazz": { "brick": { "attributeGS1": [], "code": "10001333", "label": "Kleider" }, "code": "67010200", "label": "Ganzkörperbekleidung" }, "code": "67010000", "label": "Bekleidung" }, "label": "Bekleidung" } }, "preview": false, "sapProductCategory": { "code": "46131721", "name": "Kleider", "pathCode": "0/46/4613/461317/46131721", "pathName": "Kategorien/Mode/Kindermode/Kleinkinder Mädchen/Kleider" }, "shopCategories": { "shopCategory": [ { "code": "46131721", "name": "Kleider", "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": "10007090", "name": "Röcke & Kleider", "url": "/h/kinder-roecke-kleider/h10007090" } ] ], "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": 100410967, "sequence": 1790244395797838 }, "image": "https://www.lidl.de/assets/gcp638d1e367bba4d84ab09b7d1f6df0fdb.jpg", "price": 4.99, "product_type": "HEAD_VARIANT", "title": "LUPILU® Kinder Sweatkleid", "url": "https://www.lidl.de/p/lupilu-kinder-sweatkleid/p100410967" }, { "brand": "ESMARA KIDS", "code": "100410909", "currency": "EUR", "deleted_price": 6.99, "gridbox": { "action": "UPDATE", "country": "DE", "data": { "productId": 100410909, "energyLabels": [], "isLidlGiftCard": false, "keyfacts": { "analyticsCategory": "Kategorien/Mode/Kindermode/Kinder Jungen/Jeans", "fullTitle": "ESMARA KIDS Jungen Thermo-Sweatdenim-Hose", "moreDetails": "Weitere Produktdetails", "supplementalDescription": "

Farbe: blau, schwarz
Merkmal: Optik einer Jeans - bequem wie eine Sweathose

", "title": "Jungen Thermo-Sweatdenim-Hose", "wonCategoryPrimary": "Bedürfniswelten/Mode & Accessoires/Kinderbekleidung 9-14 Jahre", "wonCategoryPrimaryPath": "0/15/1513" }, "category": "Kategorien/Mode/Kindermode/Kinder Jungen/Jeans", "lidlPlus": [], "guaranteeLabels": [], "havingPrice": true, "ians": [ "522640" ], "canonicalPath": "/p/esmara-kids-jungen-thermo-sweatdenim-hose/p100410909", "timezoneId": "Europe/Berlin", "awards": [], "ribbons": [], "regionsPrices": {}, "image": "https://www.lidl.de/assets/gcp2be2dcb657df4f9ca7c833e5630f54ce.jpg", "preventSelling": false, "renderedTs": 1789726324, "dealOfDay": { "active": false }, "image_V1": { "accessibility": "Blaue Kinder-Denim-Jogger-Jeans mit elastischem Bund und Kordelzug.", "image": "https://www.lidl.de/assets/gcp2be2dcb657df4f9ca7c833e5630f54ce.jpg" }, "cutoutimageV2": [], "havingThreesixty": false, "gs1Attributes": [], "imageList_V1": [ { "accessibility": "Blaue Kinder-Denim-Jogger-Jeans mit elastischem Bund und Kordelzug.", "image": "https://www.lidl.de/assets/gcp2be2dcb657df4f9ca7c833e5630f54ce.jpg" }, { "accessibility": "Blaue Kinder-Jeans-Jogger mit elastischem Bund und Kordelzug.", "image": "https://www.lidl.de/assets/gcp888c986e36354c92ab417058ef7f6c2d.jpg" }, { "accessibility": "Junge sitzt auf Holzbank vor Kamin, Holzinterieur und Bergblick.", "image": "https://www.lidl.de/assets/gcpc24ad5a0f96f40058194d5ac8470c964.jpg" } ], "erpNumber": "100410909", "designTheme": "default", "imageList": [ "https://www.lidl.de/assets/gcp2be2dcb657df4f9ca7c833e5630f54ce.jpg", "https://www.lidl.de/assets/gcp888c986e36354c92ab417058ef7f6c2d.jpg", "https://www.lidl.de/assets/gcpc24ad5a0f96f40058194d5ac8470c964.jpg" ], "zones": { "DE1": { "currentPrice": { "currencyCode": "EUR", "currencyCodeSecond": "", "currencySymbol": "€", "currencySymbolSecond": "", "discount": { "absoluteDiscount": 2, "bargainHintEnabled": true, "bargainHintText": "Mega Schnäppchen", "deletedPrice": 6.99, "discountHasStar": false, "fromNormalPriceForLidlPlus": false, "fromRecommendedPrice": false, "hideBargainHint": false, "percentageDiscount": 28, "showDiscount": true, "showFrom": false, "showPercentage": true, "showUpTo": false }, "endDate": "2026-10-04T21:59:59Z", "endDateExclusive": "2026-10-04T22:00Z", "hasStar": true, "hasVat": true, "hasZeroVat": false, "oldPrice": 6.99, "packaging": {}, "price": 4.99, "showEndDate": false, "specialTaxes": [], "startDate": "2026-09-17T22:00Z", "superscript": "", "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" } }, "hasColors": true, "flashSales": false, "price": { "currencyCode": "EUR", "currencyCodeSecond": "", "currencySymbol": "€", "currencySymbolSecond": "", "discount": { "absoluteDiscount": 2, "bargainHintEnabled": true, "bargainHintText": "Mega Schnäppchen", "deletedPrice": 6.99, "discountHasStar": false, "fromNormalPriceForLidlPlus": false, "fromRecommendedPrice": false, "hideBargainHint": false, "percentageDiscount": 28, "showDiscount": true, "showFrom": false, "showPercentage": true, "showUpTo": false }, "endDate": "2026-10-04T21:59:59Z", "endDateExclusive": "2026-10-04T22:00Z", "hasStar": true, "hasVat": true, "hasZeroVat": false, "oldPrice": 6.99, "packaging": {}, "price": 4.99, "showEndDate": false, "specialTaxes": [], "startDate": "2026-09-17T22:00Z", "superscript": "", "tax": "19", "variantsHaveDifferentPrices": false }, "highlightedSeals": 0, "ageRestriction": false, "brand": { "id": "ESKI", "name": "ESMARA KIDS", "showBrand": true, "url": "/q/search?q=esmara+kids" }, "store": false, "quickAddToCart": false, "fullTitle": "ESMARA KIDS Jungen Thermo-Sweatdenim-Hose", "productOrigin": "progress_event", "seals": [], "isUsedProduct": false, "categorySecondaryPath": "0/46/4613/461312/46131214", "multipack": false, "stockAvailability": { "availabilityIndicator": 3, "backInStockNotification": true, "backInStockNotificationSoldOut": true, "badgeInfo": { "badges": [ { "text": "lieferbar", "type": "AVAILABLE_ONLINE" } ] }, "badgeInfoV2": [ { "badges": [ { "text": "lieferbar", "type": "AVAILABLE_ONLINE" } ] } ], "minOrderableQuantity": 1, "onlineAvailable": true }, "displayFreeDelivery": false, "productType": "HEAD_VARIANT", "disclaimers": [ { "id": "code_100410909_85e0c753", "type": "CODE", "value": "Basic" }, { "id": "code_100410909_ce71cd6b", "type": "CODE", "value": "Price" } ], "title": "Jungen Thermo-Sweatdenim-Hose", "canonicalUrl": "/p/esmara-kids-jungen-thermo-sweatdenim-hose/p100410909", "havingVideos": false, "online": true }, "eventType": "GRIDBOX", "id": "100410909", "language": "de", "meta": { "campaignPaths": [ [ { "hiddenCategory": false, "id": "10101940", "name": "Disney, ab 1.10.", "url": "/c/disney-ab-1-10/a10101940" } ] ], "categoryPaths": [], "fullTitle": "ESMARA KIDS Jungen Thermo-Sweatdenim-Hose", "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": "46131214", "name": "Jeans", "pathCode": "0/46/4613/461312/46131214", "pathName": "Kategorien/Mode/Kindermode/Kinder Jungen/Jeans" }, "shopCategories": { "shopCategory": [ { "code": "46131214", "name": "Jeans", "parent": "461312", "superCategories": { "category": [ { "code": "461312", "name": "Kinder Jungen", "parent": "4613" }, { "code": "4613", "name": "Kindermode", "parent": "46" }, { "code": "46", "name": "Mode", "parent": "0" } ] } } ] }, "wonCategoryBreadcrumbs": [ [ { "hiddenCategory": false, "id": "10067765", "name": "Mode & Accessoires", "url": "/c/mode-accessoires/s10067765" }, { "hiddenCategory": false, "id": "10067570", "name": "Kinderbekleidung 9-15 Jahre", "url": "/h/kinderbekleidung-9-14-jahre/h10067570" } ], [ { "hiddenCategory": false, "id": "10067765", "name": "Mode & Accessoires", "url": "/c/mode-accessoires/s10067765" }, { "hiddenCategory": false, "id": "10067570", "name": "Kinderbekleidung 9-15 Jahre", "url": "/h/kinderbekleidung-9-14-jahre/h10067570" }, { "hiddenCategory": false, "id": "10070293", "name": "Bekleidung", "url": "/h/bekleidung/h10070293" } ], [ { "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": "10007089", "name": "Kinderhosen", "url": "/h/kinder-hosen-jeans/h10007089" } ] ], "worldOfNeeds": [ { "code": "1513", "isMain": true, "name": "Kinderbekleidung 9-14 Jahre", "parent": "15", "superCategories": [ { "code": "15", "name": "Mode & Accessoires", "parent": "0" }, { "code": "0", "name": "Bedürfniswelten", "parent": "" } ] } ] }, "productId": 100410909, "sequence": 1789726324707121 }, "image": "https://www.lidl.de/assets/gcp2be2dcb657df4f9ca7c833e5630f54ce.jpg", "price": 4.99, "product_type": "HEAD_VARIANT", "title": "ESMARA KIDS Jungen Thermo-Sweatdenim-Hose", "url": "https://www.lidl.de/p/esmara-kids-jungen-thermo-sweatdenim-hose/p100410909" }, { "brand": "LUPILU®", "code": "100408149", "currency": "EUR", "deleted_price": 39.99, "description": "

LUPILU® Babywippe – Kompakte Babywippe für Neugeborene und Säuglinge, ideal für Ruhephasen zu Hause und unterwegs