Carrefour UAE APIcarrefouruae.com ↗
Retrieve product details, EAN barcodes, pricing, availability, brand, origin, and images from Carrefour UAE using a single product ID lookup.
What is the Carrefour UAE API?
The Carrefour UAE API exposes 1 endpoint — get_product — that returns 10+ structured fields for any product listed on carrefouruae.com, including EAN barcode, discounted and original pricing, brand, country of origin, category hierarchy, and image URLs. Submit a numeric Carrefour UAE product ID and receive a complete product record suitable for catalog building, price monitoring, or barcode lookup workflows.
curl -X POST 'https://api.parse.bot/scraper/36abb888-6165-4da1-a1ce-dcf164598806/get_product' \
-H 'X-API-Key: $PARSE_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"product_id": "1590989"
}'Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace carrefouruae-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: Carrefour UAE SDK — bounded, re-runnable; every call capped."""
from parse_apis.carrefouruae_com_api import CarrefourUAE, ProductNotFound
client = CarrefourUAE()
# Fetch a product by its Carrefour UAE ID
product = client.products.get(product_id="1590989")
print(product.name, product.ean, product.price.currency, product.price.original_price)
# Access nested typed fields
for cat in product.categories:
print(cat.level, cat.name)
print(product.brand.name, product.origin, product.stock_status)
# Typed error handling for a missing product
try:
missing = client.products.get(product_id="0000000000")
print(missing.name)
except ProductNotFound as e:
print("not found:", e.product_id)
print("exercised: products.get")
Retrieve full product details including barcode (EAN), pricing, availability, brand, origin, category hierarchy, and images for a given Carrefour UAE product ID. Returns a single product record or an error when the ID does not match any listed product.
| Param | Type | Description |
|---|---|---|
| product_idrequired | string | Carrefour UAE numeric product identifier (e.g. 1590989). |
{
"type": "object",
"fields": {
"id": "string — product ID",
"ean": "string — EAN/barcode",
"name": "string — product name",
"size": "string — pack size",
"type": "string — product type (e.g. FOOD)",
"unit": "object with unit of measure details",
"brand": "object containing id and name",
"price": "object with currency, original_price, discounted_price, discount_percentage",
"images": "array of image URLs",
"origin": "string — country of origin",
"is_bulk": "boolean",
"supplier": "string — seller name",
"food_type": "string — food category (e.g. DRY)",
"categories": "array of category objects (id, name, level)",
"is_express": "boolean",
"product_url": "string — relative product page URL",
"is_available": "boolean",
"max_quantity": "integer — max orderable quantity",
"stock_status": "string — stock level status",
"is_marketplace": "boolean"
},
"sample": {
"data": {
"id": "1590989",
"ean": "6291001014583",
"name": "Masafi Pure Drinking Water 330ml Pack of 12",
"size": "330mlx12",
"type": "FOOD",
"unit": {
"max": 10,
"min": 1,
"size": "330mlx12",
"unitItem": 0,
"maxToOrder": 10,
"incrementBy": 1,
"itemsPerUnit": 0,
"unitOfMeasure": "pieces"
},
"brand": {
"id": "01087",
"name": "Masafi"
},
"price": {
"currency": "AED",
"original_price": 7.19,
"formatted_price": "AED7.19",
"discounted_price": 5.99,
"discount_end_date": "8/6/2026, 7:59:00 PM",
"discount_percentage": 17,
"formatted_discounted_price": "AED5.99"
},
"images": [
"https://cdn.mafrservices.com/pim-content/UAE/media/product/1590989/1739906403/1590989_main.jpg?im=Resize=1700"
],
"origin": "United Arab Emirates",
"is_bulk": false,
"supplier": "Carrefour",
"food_type": "DRY",
"categories": [
{
"id": "F1500000",
"name": "Beverages",
"level": 1
},
{
"id": "F1570000",
"name": "Water",
"level": 2
},
{
"id": "F1570400",
"name": "Still Water",
"level": 3
}
],
"is_express": false,
"product_url": "/mafuae/en/still-water/masafi-330mlx12-special-offer-/p/1590989",
"is_available": true,
"max_quantity": 10,
"stock_status": "inStock",
"is_marketplace": false
},
"status": "success"
}
}About the Carrefour UAE API
What the API Returns
The get_product endpoint accepts a single required input — product_id — which is the numeric identifier found in Carrefour UAE product URLs (e.g. 1590989). The response contains the product's ean barcode string, name, size, and type (such as FOOD), along with a unit object describing unit-of-measure details. The brand object includes both a brand id and human-readable name, and the origin field identifies the country of manufacture or sourcing.
Pricing and Availability
The price object returns currency, original_price, discounted_price, and discount_percentage, giving you the full picture of any active promotion. When a product is not on sale, discounted_price and discount_percentage reflect that. The images array provides direct image URLs so you can display or archive product visuals alongside catalog data.
Behavior and Scope
Submitting a product_id that does not match any active Carrefour UAE listing returns an error response rather than an empty result, so callers can distinguish between a missing product and a network issue. Coverage is limited to the UAE storefront (carrefouruae.com); other Carrefour regional storefronts are not in scope for this API.
The Carrefour UAE API is a managed, monitored endpoint for carrefouruae.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when carrefouruae.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official carrefouruae.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Look up EAN barcodes for grocery products by Carrefour UAE product ID to enrich an internal product catalog
- Monitor discounted_price and discount_percentage fields to track promotional pricing changes over time
- Retrieve country of origin and brand data for import compliance or product labeling workflows
- Aggregate product images from the images array for a reseller or comparison shopping interface
- Cross-reference pack size and unit details with supplier data for inventory reconciliation
- Build a price alert system by comparing original_price to discounted_price for specific product IDs
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.