Carrefour

Carrefour Reviews API

Customer reviews of one carrefour.fr product by EAN, 1 to 50 per call (default 10), sorted most recent (default), oldest, highest rated or lowest rated, optionally only one star rating, with offset paging. Returns total and has_more, and per review the author (first name and last initial, as published), rating, title, text, reviewed_at, purchased_at and source (the site's verified-review provider). Review text is in French, as written. France only. Costs 1 credit per request.

POST/api/v1/carrefour/reviews

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).

Body

application/json

eanstringrequired

The product barcode (EAN / GTIN, 8-14 digits): items[].ean of a search.

Example: 8006530256179

countryenum<string>default:fr

fr only: this endpoint covers carrefour.fr (France) and nothing else. Any other value is a 400.

Example: fr

fr — France (carrefour.fr). The only value.

sortenum<string>default:most_recent

The order of the reviews.

Example: lowest_rated

most_recent — Newest first. The default.
oldest — Oldest first.
highest_rated — Highest star rating first.
lowest_rated — Lowest star rating first.

ratinginteger

Only reviews with this many stars, 1-5.

Example: 1

limitinteger

Reviews to return, 1-50. Defaults to 10.

Example: 50

offsetinteger

Reviews to skip, for paging. Defaults to 0.

Example: 50

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

# Every review of a product, 50 at a time.
ean, offset, reviews = "8006530256179", 0, []
while True:
    res = client.carrefour.reviews(ean=ean, limit=50, offset=offset)["data"]
    reviews += res["reviews"]
    if not res["has_more"]:
        break
    offset += 50
print(len(reviews), "of", res["total"])

Response

"ean": "8006530256179",

"sort": "most_recent",

"rating": null,

"limit": 10,

"offset": 0,

"total": 76,

"count": 10,

"has_more": true,

"country": "fr",

"language": "fr",

"currency": "EUR"

"response_time": 1045

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") # Every review of a product, 50 at a time. ean, offset, reviews = "8006530256179", 0, [] while True: res = client.carrefour.reviews(ean=ean, limit=50, offset=offset)["data"] reviews += res["reviews"] if not res["has_more"]: break offset += 50 print(len(reviews), "of", res["total"])