Carrefour KSA API
Search Carrefour KSA products, prices, promotions, categories, and enriched product details.
carrefourksa
Capabilities
Every capability uses the same POST /execute envelope. Open an endpoint for
its exact ID, input contract, code samples, cost, runtime, and illustrative output.
Each endpoint lists its cost in credits per request; the
pricing page shows what credits cost.
carrefourksa.categories.list
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.
carrefourksa.category.products.list
List one 0-based page of a leaf category shelf with SAR prices, discounts, availability, supplier (1P/3P), and product URLs.
carrefourksa.product.detail.get
Product detail get
carrefourksa.products.search
Search Carrefour KSA's anonymous product catalog by keyword with 0-based pagination, SAR prices, discounts, availability, suppliers, and product URLs.
carrefourksa.promotions.list
List genuinely discounted products from a selected live Carrefour KSA campaign: Best Deals, Weekend Sale, or Monthly Stock Up.
Common uses
- 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
Integration contract
A 200 response completed inline. A 202 response was queued; poll
GET /jobs/:id until it reaches completed or failed.
- Authenticate REST requests
- Poll jobs and retrieve results
- Handle errors and safe retries
- Understand credits and limits
Use Carrefour KSA data in Claude or connect another AI client with the MCP server.