Carrefour Product

GET

/v2/carrefour/product

GET

/v2/carrefour/product

Read one Carrefour.fr product from its page URL. Every product returns the same keys: price, brand, pack size, Nutriscore, categories, unit price, and customer reviews.

Credit cost: 2 credits per call

Autorisierung

ApiKeyAuth

headerx-api-key<token>

Your API key. Include it in the x-api-key header for every request.

Abfrageparameter

query*string

Product page URL on www.carrefour.fr. The path starts with /p/.

Example:

https://www.carrefour.fr/p/oeufs-de-caille-le-gaulois-3266980075934

https://www.carrefour.fr/p/oeufs-de-caille-le-gaulois-3266980075934

A search URL or another website returns 400. The response keys stay the same on every product.

fields?string

Comma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).

is_async?boolean

Run the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.

Defaultfalse

soft_fail?boolean

Return HTTP 200 even when the request fails; the error is in the error field of the body.

Defaultfalse

Antworttext

Successful response

application/json

response

id?string

ean?string

slug?string

brand?string

image?string

price?string

title?string

contact?

currency?string

features?

packaging?string

categories?array<>

nutriscore?string

more_offers?

price_float?number

short_title?string

business_type?string

is_best_seller?boolean

price_per_unit?string

customer_reviews?

price_per_unit_float?number

price_per_unit_measure?string

price_per_unit_currency?string

Example Request

curl -X GET 'https://api.piloterr.com/v2/carrefour/product?query=string'

Example Request

curl -X GET 'https://api.piloterr.com/v2/carrefour/product?query=string'

Example ResponseSchema

{
  "id": "3155251205425",
  "ean": "3155251205425",
  "slug": "creme-fraiche-epaisse-legere-15-mg-bridelice-3155251205425",
  "brand": "BRIDELICE",
  "image": "https://media.carrefour.fr/media/referential/media/401fcdeffbdc46d69f04f16ff1c15acd/p_1500x1500/03155251205425_H1N1_s02.png",
  "price": "1,99€",
  "title": "Crème Fraiche Épaisse Légère 15% MG BRIDELICE",
  "contact": {
    "consumer": {
      "email": null,
      "phone": "09 70 82 11 25",
      "address": "- F 53089 LAVAL Cedex 9 53089 LAVAL Cedex 9",
      "website": "service.consommateurs@jevousremercie.fr",
      "company_name": "BRIDELICE"
    },
    "operator": {
      "email": null,
      "phone": null,
      "address": "15 Rue de l'Etang Z.A. Les Placis 35230 BOURGBARRE",
      "website": null,
      "company_name": "LACTALIS BEURRES ET CREMES"
    }
  },
  "currency": "€",
  "features": {
    "nom_legal": "Crème légère à 15% M.G.",
    "ingredients": "Ingrédients : Crème légère (97%) (LAIT) (origine France), amidon modifié, ferments lactiques (LAIT).",
    "valeurs_nutritionnelles": {
      "sel": "0.03 g / 25 g",
      "sucres": "1 g / 25 g",
      "glucides": "1.5 g / 25 g",
      "proteines": "0.6 g / 25 g",
      "matieres_grasses": "3.8 g / 25 g",
      "acides_gras_satures": "2.5 g / 25 g",
      "valeur_energetique_kj": "175 kJ / 25 g",
      "valeur_energetique_kcal": "42 kcal / 25 g"
    }
  },
  "packaging": "le pot de 50 cl",
  "categories": [
    {
      "id": "36993",
      "slug": "cremerie",
      "label": "Crèmerie et Produits laitiers",
      "level": 1
    },
    {
      "id": "36997",
      "slug": "beurres-cremes",
      "label": "Beurres et Crèmes",
      "level": 2
    },
    {
      "id": "28140",
      "slug": "cremes-epaisses",
      "label": "Crèmes épaisses",
      "level": 3
    }
  ],
  "nutriscore": "O",
  "more_offers": {
    "count": 0,
    "best_offer_id": null,
    "best_offer_price": null
  },
  "price_float": 1.99,
  "short_title": "Crème Fraiche Épaisse Légère 15% MG BRIDELICE",
  "business_type": "food",
  "is_best_seller": false,
  "price_per_unit": "3.98 € / L",
  "customer_reviews": {
    "count": 4,
    "rates": {
      "1": 0,
      "2": 0,
      "3": 0,
      "4": 0,
      "5": 100
    },
    "average": 5
  },
  "price_per_unit_float": 3.98,
  "price_per_unit_measure": "L",
  "price_per_unit_currency": "€"
}

{  "id": "3155251205425",  "ean": "3155251205425",  "slug": "creme-fraiche-epaisse-legere-15-mg-bridelice-3155251205425",  "brand": "BRIDELICE",  "image": "https://media.carrefour.fr/media/referential/media/401fcdeffbdc46d69f04f16ff1c15acd/p_1500x1500/03155251205425_H1N1_s02.png",  "price": "1,99€",  "title": "Crème Fraiche Épaisse Légère 15% MG BRIDELICE",  "contact": {    "consumer": {      "email": null,      "phone": "09 70 82 11 25",      "address": "- F 53089 LAVAL Cedex 9 53089 LAVAL Cedex 9",      "website": "service.consommateurs@jevousremercie.fr",      "company_name": "BRIDELICE"    },    "operator": {      "email": null,      "phone": null,      "address": "15 Rue de l'Etang Z.A. Les Placis 35230 BOURGBARRE",      "website": null,      "company_name": "LACTALIS BEURRES ET CREMES"    }  },  "currency": "€",  "features": {    "nom_legal": "Crème légère à 15% M.G.",    "ingredients": "Ingrédients : Crème légère (97%) (LAIT) (origine France), amidon modifié, ferments lactiques (LAIT).",    "valeurs_nutritionnelles": {      "sel": "0.03 g / 25 g",      "sucres": "1 g / 25 g",      "glucides": "1.5 g / 25 g",      "proteines": "0.6 g / 25 g",      "matieres_grasses": "3.8 g / 25 g",      "acides_gras_satures": "2.5 g / 25 g",      "valeur_energetique_kj": "175 kJ / 25 g",      "valeur_energetique_kcal": "42 kcal / 25 g"    }  },  "packaging": "le pot de 50 cl",  "categories": [    {      "id": "36993",      "slug": "cremerie",      "label": "Crèmerie et Produits laitiers",      "level": 1    },    {      "id": "36997",      "slug": "beurres-cremes",      "label": "Beurres et Crèmes",      "level": 2    },    {      "id": "28140",      "slug": "cremes-epaisses",      "label": "Crèmes épaisses",      "level": 3    }  ],  "nutriscore": "O",  "more_offers": {    "count": 0,    "best_offer_id": null,    "best_offer_price": null  },  "price_float": 1.99,  "short_title": "Crème Fraiche Épaisse Légère 15% MG BRIDELICE",  "business_type": "food",  "is_best_seller": false,  "price_per_unit": "3.98 € / L",  "customer_reviews": {    "count": 4,    "rates": {      "1": 0,      "2": 0,      "3": 0,      "4": 0,      "5": 100    },    "average": 5  },  "price_per_unit_float": 3.98,  "price_per_unit_measure": "L",  "price_per_unit_currency": "€"}

{ "id": "3155251205425", "ean": "3155251205425", "slug": "creme-fraiche-epaisse-legere-15-mg-bridelice-3155251205425", "brand": "BRIDELICE", "image": "https://media.carrefour.fr/media/referential/media/401fcdeffbdc46d69f04f16ff1c15acd/p_1500x1500/03155251205425_H1N1_s02.png", "price": "1,99€", "title": "Crème Fraiche Épaisse Légère 15% MG BRIDELICE", "contact": { "consumer": { "email": null, "phone": "09 70 82 11 25", "address": "- F 53089 LAVAL Cedex 9 53089 LAVAL Cedex 9", "website": "service.consommateurs@jevousremercie.fr", "company_name": "BRIDELICE" }, "operator": { "email": null, "phone": null, "address": "15 Rue de l'Etang Z.A. Les Placis 35230 BOURGBARRE", "website": null, "company_name": "LACTALIS BEURRES ET CREMES" } }, "currency": "€", "features": { "nom_legal": "Crème légère à 15% M.G.", "ingredients": "Ingrédients : Crème légère (97%) (LAIT) (origine France), amidon modifié, ferments lactiques (LAIT).", "valeurs_nutritionnelles": { "sel": "0.03 g / 25 g", "sucres": "1 g / 25 g", "glucides": "1.5 g / 25 g", "proteines": "0.6 g / 25 g", "matieres_grasses": "3.8 g / 25 g", "acides_gras_satures": "2.5 g / 25 g", "valeur_energetique_kj": "175 kJ / 25 g", "valeur_energetique_kcal": "42 kcal / 25 g" } }, "packaging": "le pot de 50 cl", "categories": [ { "id": "36993", "slug": "cremerie", "label": "Crèmerie et Produits laitiers", "level": 1 }, { "id": "36997", "slug": "beurres-cremes", "label": "Beurres et Crèmes", "level": 2 }, { "id": "28140", "slug": "cremes-epaisses", "label": "Crèmes épaisses", "level": 3 } ], "nutriscore": "O", "more_offers": { "count": 0, "best_offer_id": null, "best_offer_price": null }, "price_float": 1.99, "short_title": "Crème Fraiche Épaisse Légère 15% MG BRIDELICE", "business_type": "food", "is_best_seller": false, "price_per_unit": "3.98 € / L", "customer_reviews": { "count": 4, "rates": { "1": 0, "2": 0, "3": 0, "4": 0, "5": 100 }, "average": 5 }, "price_per_unit_float": 3.98, "price_per_unit_measure": "L", "price_per_unit_currency": "€" }

Carrefour Product

AutorisierungAnkerlink kopieren

AbfrageparameterAnkerlink kopieren

AntworttextAnkerlink kopieren

Autorisierung

Abfrageparameter

Antworttext