Carrefour

Carrefour Store Details & Fuel Prices API

One Carrefour store page in France by slug or URL: id, store_ref and pickup refs, name, banner, format, type, status, address, coordinates, phone, services, weekly opening hours and drive hours, the next pickup slot as the page shows it, delivery and express-delivery flags and the nearest stores; and, at stores with a fuel station, fuel prices per litre (Gazole, SP95, SP95-E10, SP98, E85, GPLc) with their update times (null elsewhere). France only. Costs 1 credit per request.

POST/api/v1/carrefour/store

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

slugstring

A store page slug: stores[].slug from the stores endpoint (e.g. lyon-part-dieu, venissieux). One of slug or url is required.

Example: venissieux

urlstring

A carrefour.fr/magasin/... store page URL. Alternative to slug.

Example: https://www.carrefour.fr/magasin/venissieux

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")

# Fuel prices at the Carrefour stations near a postal code.
stations = client.carrefour.stores(postal_code="69003", service="station_service")["data"]["stores"]
for s in stations[:3]:
    fuel = client.carrefour.store(slug=s["slug"])["data"]["fuel"]
    if fuel:
        print(s["name"], [(f["fuel"], f["price_per_litre"]) for f in fuel["prices"]], fuel["updated_at"])

Response

"country": "fr",

"language": "fr",

"currency": "EUR"

"response_time": 6210

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") # Fuel prices at the Carrefour stations near a postal code. stations = client.carrefour.stores(postal_code="69003", service="station_service")["data"]["stores"] for s in stations[:3]: fuel = client.carrefour.store(slug=s["slug"])["data"]["fuel"] if fuel: print(s["name"], [(f["fuel"], f["price_per_litre"]) for f in fuel["prices"]], fuel["updated_at"])