GET
/
api
/
v2
/
carrefour
/
product
curl --request GET \
  --url https://piloterr.com/api/v2/carrefour/product \
  --header 'x-api-key: <x-api-key>'
{
    "brand": "GAULOIS",
    "image": "https://media.carrefour.fr/medias/ed17057cca61469e8b147748c864660b/p_1500x1500/03266980075934_A1N1_s01.png",
    "price": "3,65€",
    "title": "Œufs de caille LE GAULOIS",
    "currency": "€",
    "features": {
        "nom_legal": "Oeufs de cailles",
        "ingredients": "100% OEUF",
        "valeurs_nutritionnelles": {
            "matieres_grasses": "14 g / 100 g",
            "acides_gras_satures": "4.9 g / 100 g",
            "valeur_energetique_kj": "737 kJ / 100 g",
            "valeur_energetique_kcal": "178 kcal / 100 g"
        }
    },
    "packaging": "la boite de 18",
    "nutriscore": "B",
    "price_float": 3.65,
    "price_per_unit": "18.25 € / KG",
    "price_per_unit_float": 18.25,
    "price_per_unit_measure": "KG",
    "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

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

Response

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 boîte de 18”)

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. “18.25 € / KG”)

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. €)

{
    "brand": "GAULOIS",
    "image": "https://media.carrefour.fr/medias/ed17057cca61469e8b147748c864660b/p_1500x1500/03266980075934_A1N1_s01.png",
    "price": "3,65€",
    "title": "Œufs de caille LE GAULOIS",
    "currency": "€",
    "features": {
        "nom_legal": "Oeufs de cailles",
        "ingredients": "100% OEUF",
        "valeurs_nutritionnelles": {
            "matieres_grasses": "14 g / 100 g",
            "acides_gras_satures": "4.9 g / 100 g",
            "valeur_energetique_kj": "737 kJ / 100 g",
            "valeur_energetique_kcal": "178 kcal / 100 g"
        }
    },
    "packaging": "la boite de 18",
    "nutriscore": "B",
    "price_float": 3.65,
    "price_per_unit": "18.25 € / KG",
    "price_per_unit_float": 18.25,
    "price_per_unit_measure": "KG",
    "price_per_unit_currency": "€"
}