Skip to main content
GET
https://piloterr.com
/
api
/
v2
/
carrefour
/
product
Carrefour Product
curl --request GET \
  --url https://piloterr.com/api/v2/carrefour/product \
  --header 'x-api-key: <x-api-key>'
  {
    "id": "3276554163158",
    "slug": "lait-demi-ecreme-demi-ecreme-carrefour-classic-3276554163158",
    "brand": "CLASSIC'",
    "image": "https://media.carrefour.fr/medias/6236a56cbc6c46c4a47aaeea5b9ffe0b/p_1500x1500/3276554163158-photosite-20241112-171948-0.jpg",
    "price": "1,08€",
    "title": "Lait Demi-Ecrémé demi-écrémé CARREFOUR CLASSIC'",
    "currency": "€",
    "features": {
      "nom_legal": "Lait demi-écrémé stérilisé UHT",
      "valeurs_nutritionnelles": {
        "matieres_grasses": "1.6 g / 100 ml",
        "valeur_energetique_kj": "197 kJ / 100 ml",
        "valeur_energetique_kcal": "47 kcal / 100 ml",
        "dont_acides_gras_satures": "1 g / 100 ml"
      }
    },
    "packaging": "la bouteille 1L",
    "nutriscore": "A",
    "price_float": 1.08,
    "price_per_unit": "1.08 € / L",
    "price_per_unit_float": 1.08,
    "price_per_unit_measure": "L",
    "price_per_unit_currency": "€"
  }
Currently, only carrefour.fr domain is supported.
​
x-api-key
string
required
This parameter specifies the private key you’ll need for Piloterr access.

​
Parameters

​
query
string
required
Carrefour product like https://www.carrefour.fr/p/oeufs-de-caille-le-gaulois-3266980075934

​
Response

​
id
string
Unique product identifier (can be EAN or internal ID)
​
slug
string
Slug to the product detail page on Carrefour
​
brand
string
Brand of the product
​
image
string
URL to the product image
​
price
string
Displayed product price (as string, with currency symbol)
​
title
string
Product title
​
currency
string
Currency symbol used for display
​
packaging
string
Packaging description (e.g. “la bouteille 1L”)
​
nutriscore
string
Nutri-Score value (A to E)
​
price_float
number
Product price as float
​
price_per_unit
string
Price per unit, as formatted string (e.g. “1.08 € / L”)
​
price_per_unit_float
number
Unit price as a float
​
price_per_unit_measure
string
Unit of measure for price (e.g. KG, L)
​
price_per_unit_currency
string
Currency used in unit price (e.g. €)
  {
    "id": "3276554163158",
    "slug": "lait-demi-ecreme-demi-ecreme-carrefour-classic-3276554163158",
    "brand": "CLASSIC'",
    "image": "https://media.carrefour.fr/medias/6236a56cbc6c46c4a47aaeea5b9ffe0b/p_1500x1500/3276554163158-photosite-20241112-171948-0.jpg",
    "price": "1,08€",
    "title": "Lait Demi-Ecrémé demi-écrémé CARREFOUR CLASSIC'",
    "currency": "€",
    "features": {
      "nom_legal": "Lait demi-écrémé stérilisé UHT",
      "valeurs_nutritionnelles": {
        "matieres_grasses": "1.6 g / 100 ml",
        "valeur_energetique_kj": "197 kJ / 100 ml",
        "valeur_energetique_kcal": "47 kcal / 100 ml",
        "dont_acides_gras_satures": "1 g / 100 ml"
      }
    },
    "packaging": "la bouteille 1L",
    "nutriscore": "A",
    "price_float": 1.08,
    "price_per_unit": "1.08 € / L",
    "price_per_unit_float": 1.08,
    "price_per_unit_measure": "L",
    "price_per_unit_currency": "€"
  }