Piloterr

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

Autorização

ApiKeyAuth
headerx-api-key<token>

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

Parâmetros de consulta

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

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

Corpo da resposta

Successful response

application/json
  1. 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 Response
{  "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": "€"}