Platform API Commerce & delivery

Carrefour KSA API

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

Platform ID carrefourksa

Endpoints 3 capabilities

Status 92.3% success rate

# Carrefour KSA API

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

- Platform ID: `carrefourksa`
- Capabilities: 3
- Execute endpoint: `POST https://data.upscrape.com/execute`
- OpenAPI: https://upscrape.com/scrapers/carrefourksa/openapi.json

## Capabilities

| Endpoint | Capability ID | Cost | Description |
| --- | --- | --- | --- |
| [Categories List](https://docs.upscrape.com/docs/platforms/carrefourksa/carrefourksa.categories.list) | `carrefourksa.categories.list` | 1 credit per request | 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. |
| [Category Products List](https://docs.upscrape.com/docs/platforms/carrefourksa/carrefourksa.category.products.list) | `carrefourksa.category.products.list` | 1 credit per request | List one 0-based page of a leaf category shelf with SAR prices, discounts, availability, supplier (1P/3P), and product URLs. |
| [Product Detail Get](https://docs.upscrape.com/docs/platforms/carrefourksa/carrefourksa.product.detail.get) | `carrefourksa.product.detail.get` | 1 credit per request | 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. |

## 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

All capabilities use the shared `POST /execute` envelope. A `200` response completed inline; a `202` response must be polled through `GET /jobs/{id}`.

See [authentication](https://docs.upscrape.com/docs/api/authentication), [jobs and results](https://docs.upscrape.com/docs/api/jobs), and [errors and retries](https://docs.upscrape.com/docs/api/errors).

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.

Endpoint Description Cost

Categories List 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.

1 credit per request

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.

1 credit per request

Product Detail Get carrefourksa.product.detail.get

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.

1 credit per request

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.