Carrefour API : produits, offres et magasins en JSON
Carrefour ne publie pas d'API ouverte aux développeurs. Ce qui revient ici, c'est ce que carrefour.fr affiche publiquement, rendu en JSON : les produits et leurs prix, les vendeurs de la marketplace, les promotions en cours et les magasins. Un point pratique : les produits se retrouvent par EAN, ce qui évite de dépendre d'identifiants internes.
Endpoints
| endpoint | Ce qui est renvoyé | Obligatoires |
|---|---|---|
| product/offers | Toutes les offres d'un produit carrefour.fr (par EAN ou URL) : l'offre Carrefour et celles de la marketplace. | tous optionnels |
| product/reviews | Les avis clients vérifiés d'un produit, paginés et triables. | tous optionnels |
| category | Parcourir une catégorie (par exemple 'cremerie/laits' ou 'image-son/televiseurs'). | category |
| deals | Le hub des promotions : tous les produits en promotion, avec prix barré et mécanique de remise. | tous optionnels |
| seller/profile | La page publique d'un vendeur marketplace : nom, logo, description, politique de retour. | seller_id |
| seller/products | Tout ce qu'un vendeur marketplace propose, avec les mêmes tris et filtres. | seller_id |
| seller/reviews | Les avis des acheteurs sur un vendeur marketplace. | seller_id |
| stores | Les magasins Carrefour les plus proches d'un code postal ou d'un point GPS. | tous optionnels |
| search/suggest | L'autocomplétion de carrefour.fr pour un début de mot-clé. | query |
| search | Recherche par mot-clé pour les sites AE / EG / BR (pays, requête, page, limite). | query |
| product/detail | Fiche produit pour les sites AE / EG / BR, à partir de l'identifiant renvoyé par la recherche de ce pays. | tous optionnels |
Chaque appel est facturé en crédits. Les appels en échec ou bloqués sont gratuits.
Exemple qui fonctionne
Pour la France, le point d'entrée naturel est l'EAN : vous partez du code-barres du produit et vous obtenez toutes les offres, sans passer par un identifiant interne qui peut changer.
curl -X POST https://api.reefapi.com/carrefour-fr/v1/product/offers \
-H "x-api-key: VOTRE_CLE" \
-H "content-type: application/json" \
-d '{"ean": "3270190022626"}'{
"ok": true,
"data": {
"offers": [
{
"seller": "Carrefour",
"price": 2.45,
"currency": "EUR",
"availability": "..."
}
]
},
"meta": { "record_count": 4, "cache_hit": false, "mode": "live" }
}Plutôt que votre propre scraper Carrefour
Un scraper maison pour carrefour.fr tourne le premier jour. Ce qui coûte vient après : la structure des fiches change et l'analyseur renvoie une liste vide au lieu d'une erreur, puis sur un parcours long la protection anti-robot interrompt le travail en plein milieu.
Ici la maintenance est de notre côté : si le schéma change nous réparons le moteur, et en cas de blocage un code d'erreur revient sans que l'appel soit facturé.
Pour une extraction ponctuelle votre script reste moins cher, nous le disons franchement. Pour un suivi qui doit tourner tous les jours, le coût est dans les pannes silencieuses, pas dans le code.
Limites et remarques honnêtes
- Ce n'est pas l'API officielle de Carrefour et nous n'avons aucun partenariat avec Carrefour.
- La recherche par mot-clé couvre les sites AE / EG / BR ; pour la France, on part de l'EAN ou de l'URL du produit.
- Les prix et la disponibilité varient selon le magasin ; ce qui revient est ce que le site publie pour le contexte demandé.
- Pas de cache : chaque appel reflète l'état au moment de la requête.