Carrefour

Carrefour Store Availability API

Whether the Carrefour stores around a French postal code carry one product (by EAN): per store, available yes or no and the distance in km, with the store's id, ref and pickup refs, name, banner, format, address, coordinates, phone, weekly opening hours and drive hours, and the slug for the store endpoint. Availability only, no price and no unit count: for a store's price, call search or product with store set to stores[].store.ref. France only. Costs 1 credit per request.

POST/api/v1/carrefour/store-availability

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).

Body

application/json

eanstringrequired

The product barcode (EAN / GTIN, 8-14 digits): items[].ean of a search.

Example: 3017620422003

postal_codestringrequired

A French postal code (5 digits): the stores around it are checked.

Example: 69003

countryenum<string>default:fr

fr only: this endpoint covers carrefour.fr (France) and nothing else. Any other value is a 400.

Example: fr

fr — France (carrefour.fr). The only value.

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

# Which stores near 69003 carry the jar, then each one's price.
res = client.carrefour.store_availability(ean="3017620422003", postal_code="69003")["data"]
print(res["available_count"], "of", res["count"], "stores carry it")
for s in res["stores"][:3]:
    if s["available"]:
        p = client.carrefour.product(ean=res["ean"], store=s["store"]["ref"])["data"]
        print(s["store"]["name"], s["distance_km"], p["price"])

Response

"ean": "3017620422003",

"postal_code": "69003",

"count": 20,

"available_count": 20,

"note": "availability only, no price: for a store's price call search or product with store set to stores[].store.ref",

"country": "fr",

"language": "fr",

"currency": "EUR"

"response_time": 720

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") # Which stores near 69003 carry the jar, then each one's price. res = client.carrefour.store_availability(ean="3017620422003", postal_code="69003")["data"] print(res["available_count"], "of", res["count"], "stores carry it") for s in res["stores"][:3]: if s["available"]: p = client.carrefour.product(ean=res["ean"], store=s["store"]["ref"])["data"] print(s["store"]["name"], s["distance_km"], p["price"])