API

Cdiscount API : produits et offres vendeurs en JSON

Cdiscount propose une API marketplace aux vendeurs sous contrat ; elle répond à une autre question, celle de votre propre catalogue. Celle-ci lit ce que le site affiche publiquement : produits, prix, vendeurs et avis, rendus en JSON. Le point utile ici est le reconditionné : il apparaît dans les offres au même titre que le neuf, ce qui change le prix de référence.

Endpoints

endpointCe qui est renvoyéObligatoires
searchRecherche par mot-clé avec les tris et filtres du site (état, vendeur, prix).query
product/detailLa fiche produit par URL ou identifiant : titre, marque, EAN et prix de la buy-box.tous optionnels
product/offersToutes les offres pour un produit, neuf comme reconditionné, avec le vendeur et son prix.tous optionnels
product/reviewsLes avis clients d'un produit, paginés et triables, avec la note.tous optionnels
search/suggestL'autocomplétion de Cdiscount pour un début de requête : suggestions de produits avec titre, URL et prix.query

Chaque appel est facturé en crédits. Les appels en échec ou bloqués sont gratuits.

Exemple qui fonctionne

Comparer sur le seul prix de la buy-box fausse le résultat : sur Cdiscount le reconditionné cohabite avec le neuf dans la même fiche, et c'est souvent lui le prix le plus bas affiché.

Requête
curl -X POST https://api.reefapi.com/cdiscount/v1/product/offers \
  -H "x-api-key: VOTRE_CLE" \
  -H "content-type: application/json" \
  -d '{"product_id": "..."}'
Réponse (abrégée)
{
  "ok": true,
  "data": {
    "offers": [
      {
        "seller": "...",
        "price": 289.99,
        "currency": "EUR",
        "condition": "neuf"
      }
    ]
  },
  "meta": { "record_count": 9, "cache_hit": false, "mode": "live" }
}

Plutôt que votre propre scraper Cdiscount

Un scraper maison pour Cdiscount 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.

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 une veille quotidienne, le coût est dans les pannes silencieuses.

Limites et remarques honnêtes

  • Ce n'est pas l'API marketplace officielle de Cdiscount et nous n'avons aucun partenariat avec Cdiscount.
  • Les offres mêlent neuf et reconditionné ; l'état est un champ à part, à ne pas ignorer dans une comparaison.
  • Si la fiche ne publie pas d'EAN, le champ revient vide ; nous ne le devinons pas.
  • Pas de cache : chaque appel reflète l'état au moment de la requête.