Maisons du Monde

Maisons du Monde Stores API

Up to 10 Maisons du Monde stores nearest a postcode, nearest first: store id, name, address, postcode, city, coordinates, distance in km, store page URL, whether it is open now, opening hours per day and its click and collect level. On fr, be, de, es, it, pt and ch. The store id is what store and availability take. Costs 1 credit per request.

POST/api/v1/maisonsdumonde/stores

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

postcodestringrequired

A postcode of the market: 5 digits on fr, de, es and it, 4 on be and ch, 1000-001 on pt.

Example: 75011

countrystringdefault:fr

The Maisons du Monde market, as a lowercase code. This endpoint serves the 7 markets the store finder covers: fr, be, de, es, it, pt and ch (nl and lu return no stores). 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).
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.

Example: nl

limitintegerdefault:10

Stores to return, nearest first, 1 to 10.

Example: 5

Request

from scavio import ScavioClient

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

r = client.maisonsdumonde.stores(postcode="75011", country="fr", limit=5)["data"]
for s in r["stores"]:
    print(s["id"], s["name"], s["city"], s["distance_km"], "km", "open" if s["open_now"] else "closed")

Response

"postcode": "75011",

"count": 10,

"country": "fr",

"language": "fr",

"currency": "EUR"

"response_time": 23651

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key", timeout=120) r = client.maisonsdumonde.stores(postcode="75011", country="fr", limit=5)["data"] for s in r["stores"]: print(s["id"], s["name"], s["city"], s["distance_km"], "km", "open" if s["open_now"] else "closed")