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

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

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"}'

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

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"}'

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

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"}'

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

Get an API key