Carrefour

Carrefour Search Suggestions API

The carrefour.fr search-box suggestions for a partial query: keyword completions (text and the carrefour.fr search URL) and category suggestions (the aisle, the text and a URL already filtered to that aisle). Suggestions are in French, as the site shows them. France only. Costs 1 credit per request.

POST/api/v1/carrefour/suggestions

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

querystringrequired

What a shopper has typed so far, 1-200 characters.

Example: nutel

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.

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

# Expand a seed term, then size each completion with search totals.
s = client.carrefour.suggestions(query="cafe")["data"]
for sug in s["suggestions"]:
    total = client.carrefour.search(query=sug["text"])["data"]["total"]
    print(sug["text"], total)

Response

"query": "nutel",

"count": 10,

"country": "fr",

"language": "fr",

"currency": "EUR"

"response_time": 444

}