curl -X GET 'https://api.parse.bot/scraper/bef7a272-6f45-48d6-b498-d6530e37f585/get_product?product_url=https%3A%2F%2Fwww.carrefourksa.com%2Fmafsau%2Far%2Fwhite-eggs%2Fqaryah-white-eggs-special-30-pcs%2Fp%2F752711' \ -H 'X-API-Key: $PARSE_API_KEY'
Returns the structured details of one Carrefour Saudi Arabia product given its product page URL. One page fetch per call. Output includes the product ID, title (in the language of the URL, ar or en), current and regular price in SAR (both null when the product is out of stock, since the site does not publish a price for unavailable items), EAN/GTIN barcode, brand (null when the site lists no brand for the item), main image URL plus the gallery, availability (in_stock, stock_status, available_quantity), seller, warranty, category breadcrumbs, quick-glance attributes and the grouped product specifications (an empty array when the site shows no specification table, common for grocery items). A URL whose product ID does not exist yields a stale_input error.
| Param | Type | Description |
|---|---|---|
| product_urlrequired | string | Full product page URL on carrefourksa.com, of the form https://www.carrefourksa.com/mafsau/<ar|en>/<category>/<slug>/p/<product_id>. Only the store, language and product ID segments are used. |
{
"type": "object",
"fields": {
"url": "canonical product page URL",
"brand": "brand name, null when the site lists none",
"title": "product name in the URL's language",
"images": "array of all gallery image URLs",
"barcode": "EAN/GTIN barcode string",
"currency": "ISO currency code of the prices (SAR)",
"in_stock": "boolean availability",
"warranty": "warranty text or null",
"image_url": "main product image URL",
"seller_id": "seller ID string",
"brand_code": "site brand code, null when absent",
"categories": "array of category codes",
"product_id": "string product ID (the number after /p/ in the URL)",
"breadcrumbs": "array of {id, name} category breadcrumbs",
"seller_name": "seller display name",
"product_type": "FOOD or NONFOOD",
"quick_glance": "array of {name, value} short attributes (pack size, sold by, ...)",
"stock_status": "site stock label, e.g. outOfStock or low; null when the site gives none for an in-stock item",
"current_price": "number, selling price; null when out of stock",
"regular_price": "number, price before discount (equals current_price when not discounted); null when out of stock",
"discount_value": "number, absolute discount amount, or null",
"specifications": "array of specification groups {group_code, group_name, features:[{name, value}]}",
"available_quantity": "integer purchasable quantity or null",
"discount_percentage": "number or null",
"is_marketplace_product": "boolean, true when sold by a third-party seller"
},
"sample": {
"data": {
"url": "https://www.carrefourksa.com/mafsau/ar/p/750353",
"brand": "Samsung",
"title": "سامسونج جالكسي إس 25 ألترا، ذاكرة داخلية 256 جيجابايت",
"images": [
"https://cdn.mafrservices.com/pim-content/SAU/media/product/750353/1747920603/750353_main.jpg"
],
"barcode": "2000007503533",
"currency": "SAR",
"in_stock": true,
"warranty": "مجاناً سنتان",
"image_url": "https://cdn.mafrservices.com/pim-content/SAU/media/product/750353/1747920603/750353_main.jpg",
"seller_id": "21393",
"brand_code": "05352",
"categories": [
"nfksa1200000",
"nfksa1220000",
"nfksa1220200"
],
"product_id": "750353",
"breadcrumbs": [
{
"id": "NFKSA1220200",
"name": "الهواتف الذكية"
}
],
"seller_name": "alhadaf store co",
"product_type": "NONFOOD",
"quick_glance": [],
"stock_status": "low",
"current_price": 3139,
"regular_price": 5399,
"discount_value": 2260,
"specifications": [
{
"features": [
{
"name": "لون",
"value": "تيتانيوم رمادي"
}
],
"group_code": "11003",
"group_name": "التصميم"
}
],
"available_quantity": 6,
"discount_percentage": 42,
"is_marketplace_product": true
},
"status": "success"
}
}About the Carrefourksa API
The Carrefourksa API on Parse exposes 1 endpoint for the publicly available data on carrefourksa.com. Calls return JSON over HTTPS and are billed per successful response.
Pin a release with the API-Snapshot-Version header so canonical updates don't silently change your contract.