Maisons du Monde

Maisons du Monde Store Stock API

One Maisons du Monde item's stock at one store, plus the market's delivery options: in stock or not, the store's stock count, the site's own stock text (for example fewer than 5 in stock), whether only the display piece is in store, click and collect and on-shelf availability, and home delivery, store pickup and in-store options with the home delivery from-price. Find the store id with stores first. On fr, be, de, es, it, pt and ch; Maisons du Monde items only. Costs 1 credit per request.

POST/api/v1/maisonsdumonde/availability

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 item reference (digits). Marketplace items (M...) are not stocked in stores and answer 400.

Example: 204172

store_idstringrequired

A store id from stores (stores[].id).

Example: 125

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

Request

from scavio import ScavioClient

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

# Find the stores near a postcode, then check one item's stock in each.
stores = client.maisonsdumonde.stores(postcode="75011", country="fr", limit=3)["data"]["stores"]
for s in stores:
    a = client.maisonsdumonde.availability(id="204172", store_id=s["id"], country="fr")["data"]
    print(s["name"], a["in_stock"], a["quantity"], a["stock_text"], a["display_model"])

Response

"product_id": "204172",

"in_stock": false,

"quantity": 0,

"stock_text": "Stock indisponible",

"display_model": false,

"country": "fr",

"language": "fr",

"currency": "EUR"

"response_time": 36801

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key", timeout=120) # Find the stores near a postcode, then check one item's stock in each. stores = client.maisonsdumonde.stores(postcode="75011", country="fr", limit=3)["data"]["stores"] for s in stores: a = client.maisonsdumonde.availability(id="204172", store_id=s["id"], country="fr")["data"] print(s["name"], a["in_stock"], a["quantity"], a["stock_text"], a["display_model"])