Carrefour

Carrefour Store Locator API

Carrefour stores in France near a postal code or a point, nearest first, up to 20 per page, optionally only those with one service (drive, home delivery, 2-hour pickup, fuel station, bank, travel, vehicle rental, catering, parapharmacy, pro). Each store has its id, store_ref and pickup_refs (pass either as store on search, product, category or promotions for that store's prices), name, banner (Carrefour, Market, City, Express...), format, distance in km, address, coordinates, whether it is open today and today's hours, the slug for the store endpoint and its carrefour.fr URL. Costs 1 credit per request.

POST/api/v1/carrefour/stores

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

postal_codestring

A French postal code (5 digits). One of postal_code or lat + lng is required.

Example: 69003

latnumber

Latitude in metropolitan France (41-51.5), with lng.

Example: 43.2965

lngnumber

Longitude (-5.5-10), with lat.

Example: 5.3698

serviceenum<string>

Only stores with this service. filters.services in the response lists the same values.

Example: station_service

drive — Drive pickup.
lad — Home delivery.
Retrait2h-drive — 2-hour pickup.
station_service — A fuel station (use the store endpoint for its fuel prices).
banque_assurance — Bank and insurance.
spectacles — Show tickets.
voyages — Travel.
location_vehicule — Vehicle rental.
traiteur — Catering.
Parapharmacie — Parapharmacy.
pro — Club Pro (business customers).

pageinteger

Page of stores, 1-based, up to 50.

Example: 2

limitinteger

Stores per page, 1-20. Defaults to 10.

Example: 20

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

# Stores near a postal code, then one store's prices for the same search.
stores = client.carrefour.stores(postal_code="69003")["data"]["stores"]
ref = next(s["store_ref"] for s in stores if s["store_ref"])
res = client.carrefour.search(query="nutella", store=ref)["data"]
print(ref, res["price_scope"], [(i["title"], i["price"]) for i in res["items"][:3]])

Response

"postal_code": "69003",

"lat": 45.7549,

"lng": 4.8492,

"page": 1,

"limit": 10,

"service": null,

"count": 10,

"country": "fr",

"language": "fr",

"currency": "EUR"

"response_time": 954

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") # Stores near a postal code, then one store's prices for the same search. stores = client.carrefour.stores(postal_code="69003")["data"]["stores"] ref = next(s["store_ref"] for s in stores if s["store_ref"]) res = client.carrefour.search(query="nutella", store=ref)["data"] print(ref, res["price_scope"], [(i["title"], i["price"]) for i in res["items"][:3]])