Upscrape 2.0 is here. Live platform data for agents, apps, and workflows. Upscrape 2.0 is here. REST API and MCP, one connection. Explore capabilities

Carrefour KSA scraper API

Saudi grocery catalog data from Carrefour KSA: categories, shelf listings, SAR prices, and product detail.

Commerce & delivery 3 capabilities stable 92.3% success rate
Sign in to run this Copy platform prompt

What people use it for

  • Price and discount monitoring across Saudi Arabia's largest grocery retailer
  • Assortment and category-share analysis for CPG and own-label brands in KSA
  • 1P vs 3P marketplace tracking via per-product supplier attribution
  • Availability and stock monitoring at the Riyadh store level
  • GTIN/barcode enrichment for Gulf retail data pipelines

Capabilities

Every capability is one POST /execute call that returns structured JSON.

Categories List

carrefourksa.categories.list
1 credit / request Endpoint docs Copy coding prompt

Fetch the Carrefour KSA category tree from the storefront menu, flattened into parent-linked rows with leaf flags; leaf ids feed carrefourksa.category.products.list.

Request

curl -X POST https://data.upscrape.com/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{},"capability":"carrefourksa.categories.list"}'

Sample response

{
  "categories": [
    {
      "id": "FKSA1600000",
      "leaf": false,
      "level": 1,
      "name": "Fresh Food",
      "parent": "",
      "thumbnail": "https://cdnprod.mafretailproxy.com/sys-master-root/hea/h28/10752247365662/FreshFood.png",
      "title": "Fresh Food",
      "url": "/c/FKSA1600000"
    },
    {
      "id": "FKSA1620000",
      "leaf": false,
      "level": 2,
      "name": "Chilled Food Counter",
      "parent": "FKSA1600000",
      "thumbnail": "https://framestrapimaster.blob.core.windows.net/assets/images/[redacted:token].png",
      "title": "Chilled Food Counter",
      "url": "/c/FKSA1620000"
    },
    {
      "id": "FKSA1620100",
      "leaf": true,
      "level": 3,
      "name": "Cold Cuts & Meat Snacks",
      "parent": "FKSA1620000",
      "thumbnail": "https://hybrisproduction.blob.core.windows.net/sys-master-prod/L3-images/FreshFood/1620100.png",
      "title": "Cold Cuts & Meat Snacks",
      "url": "/c/FKSA1620100"
    }
  ]
}

Input

Field Type Required Description
latitude string optional Store catchment latitude. Defaults to 24.7136 (Riyadh).
longitude string optional Store catchment longitude. Defaults to 46.6753 (Riyadh).

Category Products List

carrefourksa.category.products.list
1 credit / request Endpoint docs Copy coding prompt

List one 0-based page of a leaf category shelf with SAR prices, discounts, availability, supplier (1P/3P), and product URLs.

Request

curl -X POST https://data.upscrape.com/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"category_id":"FKSA1550000"},"capability":"carrefourksa.category.products.list"}'

Sample response

{
  "pagination": {
    "num_of_pages": 19,
    "page": 0,
    "total_products": 455
  },
  "products": [
    {
      "soldByWeight": false,
      "isBulk": false,
      "ean": "12000051999",
      "isFBC": false,
      "category": [
        {
          "aliasName": "FKSA1500000",
          "id": "FKSA1500000",
          "level": 1,
          "name": "Beverages",
          "url": "/c/FKSA1500000/"
        },
        {
          "aliasName": "FKSA1550000",
          "id": "FKSA1550000",
          "level": 2,
          "name": "Soft Drinks",
          "url": "/c/FKSA1550000/"
        }
      ],
      "freeGift": false,
      "amendableOrders": [],
      "links": {
        "defaultImages": [
          "https://cdn.mafrservices.com/sys-master-root/he8/h41/51636552597534/627660_main.jpg?im=Resize=1700"
        ],
        "images": [
          {
            "href": "https://cdn.mafrservices.com/sys-master-root/he8/h41/51636552597534/627660_main.jpg?im=Resize=200",
            "kind": "image",
            "properties": {
              "format": "plpThumbnail",
              "imageType": "GALLERY",
              "url": "https://cdn.mafrservices.com/sys-master-root/he8/h41/51636552597534/627660_main.jpg?im=Resize=200"
            },
            "rel": "assets",
            "type": "GET"
          }
        ],
        "productUrl": {
          "href": "/mafsau/en/lemonade-mixers/7-up-can-325ml-x24/p/627660",
          "kind": "product",
          "rel": "self",
          "type": "GET"
        },
        "tracking": []
      },
      "type": "FOOD",
      "promoVoucher": {},
      "variants": [],
      "dxtVouchers": [],
      "isMarketPlace": false,
      "availability": {
        "isAvailable": true,
        "max": 50
      },
      "servingIntents": [
        "SLOTTED"
      ],
      "foodType": "DRY",
      "preorder": false,
      "howGood": false,
      "bulkMessage": "",
      "isVirtualBundle": false,
      "supplier": "Carrefour",
      "delivery": [],
      "name": "7UP, Carbonated Soft Drink, Cans, 325ml x 24",
      "id": "627660",
      "promoBadges": [
        {
          "id": "4905752a-e5cc-40b4-84f2-a104030865db",
          "placement": "AREA-A",
          "priority": 10,
          "seller": "Carrefour",
          "text": {
            "boldText": "Online Exclusive Offer",
            "normalText": ""
          },
          "type": "Campaign"
        }
      ],
      "productCategoriesHearchi": "Beverages/Soft Drinks/Carbonated Drinks/Lemonade Mixers",
      "price": {
        "currency": "SAR",
        "discount": {
          "endDate": "8/4/2026, 8:59:00 PM",
          "formattedValue": "SAR52.99",
          "minBuyingValue": "52.99",
          "price": 52.99,
          "type": "percentage",
          "value": 5
        },
        "formattedValue": "SAR56.00",
        "minBuyingValue": "56.00",
        "price": 56
      },
      "warranty": false,
      "extraLoyaltyPointsEarned": 0,
      "size": "325ml x 24",
      "brand": {
        "id": "01023",
        "name": "7Up"
      },
      "isExpress": false,
      "loyaltyPoints": 0,
      "isScalable": false,
      "isRecommended": false,
      "deliveryFees": {
        "freeDeliveryThreshold": 120
      },
      "unit": {
        "incrementBy": 1,
        "itemsPerUnit": 0,
        "max": 50,
        "maxToOrder": 50,
        "min": 1,
        "size": "325ml x 24",
        "unitItem": 0,
        "unitOfMeasure": "pieces"
      },
      "page_type": "group_id",
      "stock": {
        "stockLevelStatus": "inStock"
      },
      "isDirectMatch": false,
      "offers": [
        {
          "brightbites": false,
          "id": "offer_carrefour_",
          "internationalShipping": false,
          "purchaseIndicators": {
            "SHIPPING": [
              "SLOTTED"
            ]
          },
          "sellerName": "Carrefour",
          "serviceProductTypes": null,
          "shippingIndicator": "SLOTTED",
          "shopId": "0000",
          "type": "main"
        }
      ],
      "availableVariants": []
    },
    {
      "soldByWeight": false,
      "isBulk": false,
      "ean": "12000062278",
      "isFBC": false,
      "category": [
        {
          "aliasName": "FKSA1500000",
          "id": "FKSA1500000",
          "level": 1,
          "name": "Beverages",
          "url": "/c/FKSA1500000/"
        },
        {
          "aliasName": "FKSA1550000",
          "id": "FKSA1550000",
          "level": 2,
          "name": "Soft Drinks",
          "url": "/c/FKSA1550000/"
        }
      ],
      "freeGift": false,
      "amendableOrders": [],
      "links": {
        "defaultImages": [
          "https://cdn.mafrservices.com/sys-master-root/hb8/h77/61617751752734/694540_main.jpg?im=Resize=1700"
        ],
        "images": [
          {
            "href": "https://cdn.mafrservices.com/sys-master-root/hb8/h77/61617751752734/694540_main.jpg?im=Resize=200",
            "kind": "image",
            "properties": {
              "format": "plpThumbnail",
              "imageType": "GALLERY",
              "url": "https://cdn.mafrservices.com/sys-master-root/hb8/h77/61617751752734/694540_main.jpg?im=Resize=200"
            },
            "rel": "assets",
            "type": "GET"
          }
        ],
        "productUrl": {
          "href": "/mafsau/en/lemonade-mixers/7up-zero-sugar-cans-150ml-x12/p/694540",
          "kind": "product",
          "rel": "self",
          "type": "GET"
        },
        "tracking": []
      },
      "type": "FOOD",
      "promoVoucher": {},
      "variants": [],
      "dxtVouchers": [],
      "isMarketPlace": false,
      "availability": {
        "isAvailable": true,
        "max": 50
      },
      "servingIntents": [
        "SLOTTED"
      ],
      "foodType": "DRY",
      "preorder": false,
      "howGood": false,
      "bulkMessage": "",
      "isVirtualBundle": false,
      "supplier": "Carrefour",
      "delivery": [],
      "name": "7UP Zero Sugar Cans 150ml x12",
      "id": "694540",
      "promoBadges": [],
      "productCategoriesHearchi": "Beverages/Soft Drinks/Carbonated Drinks/Lemonade Mixers",
      "price": {
        "currency": "SAR",
        "discount": {
          "endDate": "8/4/2026, 8:59:00 PM",
          "formattedValue": "SAR15.00",
          "minBuyingValue": "15.00",
          "price": 15,
          "type": "percentage",
          "value": 17
        },
        "formattedValue": "SAR18.00",
        "minBuyingValue": "18.00",
        "price": 18
      },
      "warranty": false,
      "extraLoyaltyPointsEarned": 0,
      "size": "150ml x12",
      "brand": {
        "id": "01023",
        "name": "7Up"
      },
      "isExpress": false,
      "loyaltyPoints": 0,
      "isScalable": false,
      "isRecommended": false,
      "deliveryFees": {
        "freeDeliveryThreshold": 120
      },
      "unit": {
        "incrementBy": 1,
        "itemsPerUnit": 0,
        "max": 50,
        "maxToOrder": 50,
        "min": 1,
        "size": "150ml x12",
        "unitItem": 0,
        "unitOfMeasure": "pieces"
      },
      "page_type": "group_id",
      "stock": {
        "stockLevelStatus": "inStock"
      },
      "isDirectMatch": false,
      "offers": [
        {
          "brightbites": false,
          "id": "offer_carrefour_",
          "internationalShipping": false,
          "purchaseIndicators": {
            "SHIPPING": [
              "SLOTTED"
            ]
          },
          "sellerName": "Carrefour",
          "serviceProductTypes": null,
          "shippingIndicator": "SLOTTED",
          "shopId": "0000",
          "type": "main"
        }
      ],
      "availableVariants": []
    },
    {
      "soldByWeight": false,
      "isBulk": false,
      "ean": "12000060359",
      "isFBC": false,
      "category": [
        {
          "aliasName": "FKSA1500000",
          "id": "FKSA1500000",
          "level": 1,
          "name": "Beverages",
          "url": "/c/FKSA1500000/"
        },
        {
          "aliasName": "FKSA1550000",
          "id": "FKSA1550000",
          "level": 2,
          "name": "Soft Drinks",
          "url": "/c/FKSA1550000/"
        }
      ],
      "freeGift": false,
      "amendableOrders": [],
      "links": {
        "defaultImages": [
          "https://cdn.mafrservices.com/sys-master-root/h39/h8d/15071872942110/663739_main.jpg?im=Resize=1700"
        ],
        "images": [
          {
            "href": "https://cdn.mafrservices.com/sys-master-root/h39/h8d/15071872942110/663739_main.jpg?im=Resize=200",
            "kind": "image",
            "properties": {
              "format": "plpThumbnail",
              "imageType": "GALLERY",
              "url": "https://cdn.mafrservices.com/sys-master-root/h39/h8d/15071872942110/663739_main.jpg?im=Resize=200"
            },
            "rel": "assets",
            "type": "GET"
          }
        ],
        "productUrl": {
          "href": "/mafsau/en/cola-zero/diet-pepsi-mini-can-150ml-x12/p/663739",
          "kind": "product",
          "rel": "self",
          "type": "GET"
        },
        "tracking": []
      },
      "type": "FOOD",
      "promoVoucher": {},
      "variants": [],
      "dxtVouchers": [],
      "isMarketPlace": false,
      "availability": {
        "isAvailable": true,
        "max": 50
      },
      "servingIntents": [
        "SLOTTED"
      ],
      "foodType": "DRY",
      "preorder": false,
      "howGood": false,
      "bulkMessage": "",
      "isVirtualBundle": false,
      "supplier": "Carrefour",
      "delivery": [],
      "name": "Pepsi Cola Diet Can 150ml x 12",
      "id": "663739",
      "promoBadges": [
        {
          "id": "a72f55da-96e5-4e30-9b9c-d93188d791ca",
          "placement": "AREA-A",
          "priority": 1,
          "seller": "Carrefour",
          "text": {
            "boldText": "BESTSELLER",
            "normalText": ""
          },
          "type": "BestSeller"
        }
      ],
      "productCategoriesHearchi": "Beverages/Soft Drinks/Carbonated Drinks/Cola Zero",
      "price": {
        "currency": "SAR",
        "discount": {
          "endDate": "8/4/2026, 8:59:00 PM",
          "formattedValue": "SAR15.00",
          "minBuyingValue": "15.00",
          "price": 15,
          "type": "percentage",
          "value": 17
        },
        "formattedValue": "SAR18.00",
        "minBuyingValue": "18.00",
        "price": 18
      },
      "warranty": false,
      "extraLoyaltyPointsEarned": 0,
      "size": "150ml x 12",
      "brand": {
        "id": "12177",
        "name": "Pepsi cola"
      },
      "isExpress": false,
      "loyaltyPoints": 0,
      "isScalable": false,
      "isRecommended": false,
      "deliveryFees": {
        "freeDeliveryThreshold": 120
      },
      "unit": {
        "incrementBy": 1,
        "itemsPerUnit": 0,
        "max": 50,
        "maxToOrder": 50,
        "min": 1,
        "size": "150ml x 12",
        "unitItem": 0,
        "unitOfMeasure": "pieces"
      },
      "page_type": "group_id",
      "stock": {
        "stockLevelStatus": "inStock"
      },
      "isDirectMatch": false,
      "offers": [
        {
          "brightbites": false,
          "id": "offer_carrefour_",
          "internationalShipping": false,
          "purchaseIndicators": {
            "SHIPPING": [
              "SLOTTED"
            ]
          },
          "sellerName": "Carrefour",
          "serviceProductTypes": null,
          "shippingIndicator": "SLOTTED",
          "shopId": "0000",
          "type": "main"
        }
      ],
      "availableVariants": []
    }
  ],
  "raw": {
    "algoliaQueryID": "[redacted:token]",
    "breadCrumb": [
      {
        "aliasName": "FKSA1500000",
        "id": "FKSA1500000",
        "level": 1,
        "name": "Beverages",
        "url": "/c/FKSA1500000/"
      },
      {
        "aliasName": "FKSA1550000",
        "id": "FKSA1550000",
        "level": 2,
        "name": "Soft Drinks",
        "url": "/c/FKSA1550000/"
      }
    ],
    "exactMatch": true,
    "hybridMeta": {
      "usedHybridSplit": true,
      "vectorHits": 24
    },
    "is_food_category": true,
    "keywordSuggestions": [],
    "numOfPages": 19,
    "outOfStockProducts": [],
    "pagination": {
      "currentPage": 0,
      "pageSize": 24,
      "skip": 0,
      "sort": "relevance",
      "top": 24,
      "totalPages": 19,
      "totalResults": 455
    },
    "posInfo": {
      "DEFAULT": "301",
      "MKP_GLOBAL": "MKP_GLOBAL",
      "SLOTTED": "301"
    },
    "products": [
      {
        "soldByWeight": false,
        "isBulk": false,
        "ean": "12000051999",
        "isFBC": false,
        "category": [
          {
            "aliasName": "FKSA1500000",
            "id": "FKSA1500000",
            "level": 1,
            "name": "Beverages",
            "url": "/c/FKSA1500000/"
          },
          {
            "aliasName": "FKSA1550000",
            "id": "FKSA1550000",
            "level": 2,
            "name": "Soft Drinks",
            "url": "/c/FKSA1550000/"
          }
        ],
        "freeGift": false,
        "amendableOrders": [],
        "links": {
          "defaultImages": [
            "https://cdn.mafrservices.com/sys-master-root/he8/h41/51636552597534/627660_main.jpg?im=Resize=1700"
          ],
          "images": [
            {
              "href": "https://cdn.mafrservices.com/sys-master-root/he8/h41/51636552597534/627660_main.jpg?im=Resize=200",
              "kind": "image",
              "properties": {
                "format": "plpThumbnail",
                "imageType": "GALLERY",
                "url": "https://cdn.mafrservices.com/sys-master-root/he8/h41/51636552597534/627660_main.jpg?im=Resize=200"
              },
              "rel": "assets",
              "type": "GET"
            }
          ],
          "productUrl": {
            "href": "/mafsau/en/lemonade-mixers/7-up-can-325ml-x24/p/627660",
            "kind": "product",
            "rel": "self",
            "type": "GET"
          },
          "tracking": []
        },
        "type": "FOOD",
        "promoVoucher": {},
        "variants": [],
        "dxtVouchers": [],
        "isMarketPlace": false,
        "availability": {
          "isAvailable": true,
          "max": 50
        },
        "servingIntents": [
          "SLOTTED"
        ],
        "foodType": "DRY",
        "preorder": false,
        "howGood": false,
        "bulkMessage": "",
        "isVirtualBundle": false,
        "supplier": "Carrefour",
        "delivery": [],
        "name": "7UP, Carbonated Soft Drink, Cans, 325ml x 24",
        "id": "627660",
        "promoBadges": [
          {
            "id": "4905752a-e5cc-40b4-84f2-a104030865db",
            "placement": "AREA-A",
            "priority": 10,
            "seller": "Carrefour",
            "text": {
              "boldText": "Online Exclusive Offer",
              "normalText": ""
            },
            "type": "Campaign"
          }
        ],
        "productCategoriesHearchi": "Beverages/Soft Drinks/Carbonated Drinks/Lemonade Mixers",
        "price": {
          "currency": "SAR",
          "discount": {
            "endDate": "8/4/2026, 8:59:00 PM",
            "formattedValue": "SAR52.99",
            "minBuyingValue": "52.99",
            "price": 52.99,
            "type": "percentage",
            "value": 5
          },
          "formattedValue": "SAR56.00",
          "minBuyingValue": "56.00",
          "price": 56
        },
        "warranty": false,
        "extraLoyaltyPointsEarned": 0,
        "size": "325ml x 24",
        "brand": {
          "id": "01023",
          "name": "7Up"
        },
        "isExpress": false,
        "loyaltyPoints": 0,
        "isScalable": false,
        "isRecommended": false,
        "deliveryFees": {
          "freeDeliveryThreshold": 120
        },
        "unit": {
          "incrementBy": 1,
          "itemsPerUnit": 0,
          "max": 50,
          "maxToOrder": 50,
          "min": 1,
          "size": "325ml x 24",
          "unitItem": 0,
          "unitOfMeasure": "pieces"
        },
        "page_type": "group_id",
        "stock": {
          "stockLevelStatus": "inStock"
        },
        "isDirectMatch": false,
        "offers": [
          {
            "brightbites": false,
            "id": "offer_carrefour_",
            "internationalShipping": false,
            "purchaseIndicators": {
              "SHIPPING": [
                "SLOTTED"
              ]
            },
            "sellerName": "Carrefour",
            "serviceProductTypes": null,
            "shippingIndicator": "SLOTTED",
            "shopId": "0000",
            "type": "main"
          }
        ],
        "availableVariants": []
      },
      {
        "soldByWeight": false,
        "isBulk": false,
        "ean": "12000062278",
        "isFBC": false,
        "category": [
          {
            "aliasName": "FKSA1500000",
            "id": "FKSA1500000",
            "level": 1,
            "name": "Beverages",
            "url": "/c/FKSA1500000/"
          },
          {
            "aliasName": "FKSA1550000",
            "id": "FKSA1550000",
            "level": 2,
            "name": "Soft Drinks",
            "url": "/c/FKSA1550000/"
          }
        ],
        "freeGift": false,
        "amendableOrders": [],
        "links": {
          "defaultImages": [
            "https://cdn.mafrservices.com/sys-master-root/hb8/h77/61617751752734/694540_main.jpg?im=Resize=1700"
          ],
          "images": [
            {
              "href": "https://cdn.mafrservices.com/sys-master-root/hb8/h77/61617751752734/694540_main.jpg?im=Resize=200",
              "kind": "image",
              "properties": {
                "format": "plpThumbnail",
                "imageType": "GALLERY",
                "url": "https://cdn.mafrservices.com/sys-master-root/hb8/h77/61617751752734/694540_main.jpg?im=Resize=200"
              },
              "rel": "assets",
              "type": "GET"
            }
          ],
          "productUrl": {
            "href": "/mafsau/en/lemonade-mixers/7up-zero-sugar-cans-150ml-x12/p/694540",
            "kind": "product",
            "rel": "self",
            "type": "GET"
          },
          "tracking": []
        },
        "type": "FOOD",
        "promoVoucher": {},
        "variants": [],
        "dxtVouchers": [],
        "isMarketPlace": false,
        "availability": {
          "isAvailable": true,
          "max": 50
        },
        "servingIntents": [
          "SLOTTED"
        ],
        "foodType": "DRY",
        "preorder": false,
        "howGood": false,
        "bulkMessage": "",
        "isVirtualBundle": false,
        "supplier": "Carrefour",
        "delivery": [],
        "name": "7UP Zero Sugar Cans 150ml x12",
        "id": "694540",
        "promoBadges": [],
        "productCategoriesHearchi": "Beverages/Soft Drinks/Carbonated Drinks/Lemonade Mixers",
        "price": {
          "currency": "SAR",
          "discount": {
            "endDate": "8/4/2026, 8:59:00 PM",
            "formattedValue": "SAR15.00",
            "minBuyingValue": "15.00",
            "price": 15,
            "type": "percentage",
            "value": 17
          },
          "formattedValue": "SAR18.00",
          "minBuyingValue": "18.00",
          "price": 18
        },
        "warranty": false,
        "extraLoyaltyPointsEarned": 0,
        "size": "150ml x12",
        "brand": {
          "id": "01023",
          "name": "7Up"
        },
        "isExpress": false,
        "loyaltyPoints": 0,
        "isScalable": false,
        "isRecommended": false,
        "deliveryFees": {
          "freeDeliveryThreshold": 120
        },
        "unit": {
          "incrementBy": 1,
          "itemsPerUnit": 0,
          "max": 50,
          "maxToOrder": 50,
          "min": 1,
          "size": "150ml x12",
          "unitItem": 0,
          "unitOfMeasure": "pieces"
        },
        "page_type": "group_id",
        "stock": {
          "stockLevelStatus": "inStock"
        },
        "isDirectMatch": false,
        "offers": [
          {
            "brightbites": false,
            "id": "offer_carrefour_",
            "internationalShipping": false,
            "purchaseIndicators": {
              "SHIPPING": [
                "SLOTTED"
              ]
            },
            "sellerName": "Carrefour",
            "serviceProductTypes": null,
            "shippingIndicator": "SLOTTED",
            "shopId": "0000",
            "type": "main"
          }
        ],
        "availableVariants": []
      },
      {
        "soldByWeight": false,
        "isBulk": false,
        "ean": "12000060359",
        "isFBC": false,
        "category": [
          {
            "aliasName": "FKSA1500000",
            "id": "FKSA1500000",
            "level": 1,
            "name": "Beverages",
            "url": "/c/FKSA1500000/"
          },
          {
            "aliasName": "FKSA1550000",
            "id": "FKSA1550000",
            "level": 2,
            "name": "Soft Drinks",
            "url": "/c/FKSA1550000/"
          }
        ],
        "freeGift": false,
        "amendableOrders": [],
        "links": {
          "defaultImages": [
            "https://cdn.mafrservices.com/sys-master-root/h39/h8d/15071872942110/663739_main.jpg?im=Resize=1700"
          ],
          "images": [
            {
              "href": "https://cdn.mafrservices.com/sys-master-root/h39/h8d/15071872942110/663739_main.jpg?im=Resize=200",
              "kind": "image",
              "properties": {
                "format": "plpThumbnail",
                "imageType": "GALLERY",
                "url": "https://cdn.mafrservices.com/sys-master-root/h39/h8d/15071872942110/663739_main.jpg?im=Resize=200"
              },
              "rel": "assets",
              "type": "GET"
            }
          ],
          "productUrl": {
            "href": "/mafsau/en/cola-zero/diet-pepsi-mini-can-150ml-x12/p/663739",
            "kind": "product",
            "rel": "self",
            "type": "GET"
          },
          "tracking": []
        },
        "type": "FOOD",
        "promoVoucher": {},
        "variants": [],
        "dxtVouchers": [],
        "isMarketPlace": false,
        "availability": {
          "isAvailable": true,
          "max": 50
        },
        "servingIntents": [
          "SLOTTED"
        ],
        "foodType": "DRY",
        "preorder": false,
        "howGood": false,
        "bulkMessage": "",
        "isVirtualBundle": false,
        "supplier": "Carrefour",
        "delivery": [],
        "name": "Pepsi Cola Diet Can 150ml x 12",
        "id": "663739",
        "promoBadges": [
          {
            "id": "a72f55da-96e5-4e30-9b9c-d93188d791ca",
            "placement": "AREA-A",
            "priority": 1,
            "seller": "Carrefour",
            "text": {
              "boldText": "BESTSELLER",
              "normalText": ""
            },
            "type": "BestSeller"
          }
        ],
        "productCategoriesHearchi": "Beverages/Soft Drinks/Carbonated Drinks/Cola Zero",
        "price": {
          "currency": "SAR",
          "discount": {
            "endDate": "8/4/2026, 8:59:00 PM",
            "formattedValue": "SAR15.00",
            "minBuyingValue": "15.00",
            "price": 15,
            "type": "percentage",
            "value": 17
          },
          "formattedValue": "SAR18.00",
          "minBuyingValue": "18.00",
          "price": 18
        },
        "warranty": false,
        "extraLoyaltyPointsEarned": 0,
        "size": "150ml x 12",
        "brand": {
          "id": "12177",
          "name": "Pepsi cola"
        },
        "isExpress": false,
        "loyaltyPoints": 0,
        "isScalable": false,
        "isRecommended": false,
        "deliveryFees": {
          "freeDeliveryThreshold": 120
        },
        "unit": {
          "incrementBy": 1,
          "itemsPerUnit": 0,
          "max": 50,
          "maxToOrder": 50,
          "min": 1,
          "size": "150ml x 12",
          "unitItem": 0,
          "unitOfMeasure": "pieces"
        },
        "page_type": "group_id",
        "stock": {
          "stockLevelStatus": "inStock"
        },
        "isDirectMatch": false,
        "offers": [
          {
            "brightbites": false,
            "id": "offer_carrefour_",
            "internationalShipping": false,
            "purchaseIndicators": {
              "SHIPPING": [
                "SLOTTED"
              ]
            },
            "sellerName": "Carrefour",
            "serviceProductTypes": null,
            "shippingIndicator": "SLOTTED",
            "shopId": "0000",
            "type": "main"
          }
        ],
        "availableVariants": []
      }
    ],
    "queryCategorizationTree": [],
    "searchExperimentInfo": {
      "experimentKey": "hybridSearchFlag",
      "variationId": "3"
    },
    "sorts": [
      {
        "code": "relevance",
        "name": "Relevance",
        "selected": true
      },
      {
        "code": "price_asc",
        "name": "Price (lowest first)",
        "selected": false
      },
      {
        "code": "price_desc",
        "name": "Price (highest first)",
        "selected": false
      }
    ],
    "title": "Soft Drinks",
    "totalProducts": 455
  }
}

Input

Field Type Required Description
category_id string required Leaf category id from carrefourksa.categories.list, e.g. FKSA1550000 (Soft Drinks). Root categories return empty sponsored pages upstream; use leaf ids.
page integer optional 0-based shelf page. Defaults to 0; num_of_pages in the response is the page count.
page_size integer optional Products per page. Defaults to 24, capped at 100.
sort_by string optional Upstream sort key. Defaults to relevance.

Product Detail Get

carrefourksa.product.detail.get
1 credit / request Endpoint docs Copy coding prompt

Fetch the product detail record for a PDP URL, PDP path, or bare numeric product id: JSON-LD product data plus best-effort breadcrumbs and barcode.

Request

curl -X POST https://data.upscrape.com/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"url":"https://www.carrefourksa.com/mafsau/en/lemonade-mixers/7up-zero-sugar-cans-150ml-x12/p/694540"},"capability":"carrefourksa.product.detail.get"}'

Sample response

{
  "product": {
    "@context": "https://schema.org/",
    "@type": "Product",
    "barcode": "12000062278",
    "brand": "food_7up",
    "breadcrumbs": [
      {
        "aliasName": "FKSA1500000",
        "id": "FKSA1500000",
        "level": 1,
        "name": "Beverages",
        "name_ar": "المشروبات",
        "url": "/c/FKSA1500000/"
      },
      {
        "aliasName": "FKSA1550000",
        "id": "FKSA1550000",
        "level": 2,
        "name": "Soft Drinks",
        "name_ar": "مشروبات غازية",
        "url": "/c/FKSA1550000/"
      },
      {
        "aliasName": "FKSA1550100",
        "id": "FKSA1550100",
        "level": 3,
        "name": "Carbonated Drinks",
        "name_ar": "المشروبات الغازية والخلاطات",
        "url": "/c/FKSA1550100/"
      }
    ],
    "description": "",
    "hasMerchantReturnPolicy": {
      "@type": "MerchantReturnPolicy",
      "applicableCountry": "SAR",
      "merchantReturnDays": 7,
      "returnPolicyCategory": "https://schema.org/MerchantReturnFiniteReturnWindow"
    },
    "image": "https://cdn.mafrservices.com/sys-master-root/hb8/h77/61617751752734/694540_main.jpg",
    "name": "7UP Zero Sugar Cans 150ml x12",
    "offers": {
      "@type": "Offer",
      "availability": "https://schema.org/OutOfStock",
      "itemCondition": "https://schema.org/NewCondition",
      "priceCurrency": "SAR",
      "url": "https://www.carrefourksa.com/mafsau/en/p/694540"
    },
    "productCategory": "fksa1500000",
    "sku": "694540"
  }
}

Input

Field Type Required Description
url string required Product page locator: a full PDP URL (https://www.carrefourksa.com/mafsau/en/.../p/694540), a PDP path (/mafsau/en/.../p/694540), or a bare numeric product id (694540, resolved to the canonical /mafsau/en/p/694540 route).

Run Carrefour KSA in under a minute

Sign in, create an API key, and try any capability in the playground before you write code.

Get an API key