Maisons du Monde

Maisons du Monde Reviews API

A Maisons du Monde product's customer reviews: the rating, review count, 1-5 star histogram and per-criterion averages, then the reviews themselves (rating, text, date, author display name, the country and market a review was written in, criteria scores such as style, value for money and comfort, the brand's reply and photos), 1 to 30 per page with a cursor for the next page, sorted newest, best or worst first. Reviews are pooled across every Maisons du Monde market and shown translated into the request language. Costs 1 credit per request.

POST/api/v1/maisonsdumonde/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

idstringrequired

A Maisons du Monde product reference (the product id, digits).

Example: 186339

countrystringdefault:fr

The Maisons du Monde market, as a lowercase code. This endpoint serves all 9 Maisons du Monde markets: fr, be, lu, nl, de, es, it, pt and ch (12 market-languages). Names and labels come back in the market's language and prices in its currency (EUR, or CHF on ch), never converted; the answer echoes country, language and currency. Another market answers 400 before anything is charged (at: Maisons du Monde closed its Austrian store in 2026; gb / uk: it closed in the UK in 2023).

Example: fr

fr — France, EUR, French. Marketplace sellers. The default.
be — Belgium, EUR, French or Dutch (language fr / nl, default fr).
lu — Luxembourg, EUR, French.
nl — Netherlands, EUR, Dutch.
de — Germany, EUR, German. Marketplace sellers.
es — Spain, EUR, Spanish. Marketplace sellers.
it — Italy, EUR, Italian. Marketplace sellers.
pt — Portugal, EUR, Portuguese.
ch — Switzerland, CHF, French or German or Italian (language fr / de / it, default fr).

languagestring

The answer's language on a multi-language market: be fr (default) or nl, ch fr (default), de or it. Every other market has one language (fr and lu fr, nl nl, de de, es es, it it, pt pt). A language the market does not serve answers 400. Reviews come back translated into this language.

Example: nl

sortenum<string>default:newest

Review order. The site has no star filter.

Example: rating_asc

newest — Newest first. The default.
rating_desc — Highest rating first.
rating_asc — Lowest rating first.

cursorstring

next_cursor of the previous answer, for the next page. Keep the same sort.

Example: eyJzb3J0IjpbMTc5MTYyNTYxNjAwMCwiYjM4YjMyN2UtZWVkMy00NzEwLThjOGMtODYwNjdkN2NlNTg1Il0sImhhc2giOiI3ZjBiYTUzZSJ9

limitintegerdefault:10

Reviews per page, 1 to 30.

Example: 30

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key", timeout=120)

# Every review of one product, 30 a page, translated into French: follow next_cursor.
cursor = None
while True:
    r = client.maisonsdumonde.reviews(id="186339", country="fr", limit=30, cursor=cursor)["data"]
    for rev in r["reviews"]:
        print(rev["date"], rev["rating"], rev["source_market"], rev["text"][:80])
    cursor = r["next_cursor"]
    if not cursor:
        break

Response

"product_id": "186339",

"sort": "newest",

"rating": 4.07,

"review_count": 830,

"criteria": null,

"next_cursor": "eyJzb3J0IjpbMTc5MTYyNTYxNjAwMCwiYjM4YjMyN2UtZWVkMy00NzEwLThjOGMtODYwNjdkN2NlNTg1Il0sImhhc2giOiI3ZjBiYTUzZSJ9",

"country": "fr",

"language": "fr",

"currency": "EUR"

"response_time": 2059

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key", timeout=120) # Every review of one product, 30 a page, translated into French: follow next_cursor. cursor = None while True: r = client.maisonsdumonde.reviews(id="186339", country="fr", limit=30, cursor=cursor)["data"] for rev in r["reviews"]: print(rev["date"], rev["rating"], rev["source_market"], rev["text"][:80]) cursor = r["next_cursor"] if not cursor: break