Maisons du Monde

Maisons du Monde Search API

Search Maisons du Monde (furniture and home decor) by keyword on any of its 9 markets, in the market's language: 40 results per page with the exact total, sorted by relevance, price or customer rating and filtered by price range, discount, stock, rating, color, material, style, brand, marketplace seller or any facet. Each item has its product id, price, the crossed-out was_price and percent off, badges such as BLACK FRIDAY, rating, review count and whether Maisons du Monde or a marketplace seller sells it. A keyword that names a category answers that category's grid and says so in redirected_to. Costs 1 credit per request.

POST/api/v1/maisonsdumonde/search

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

Search keywords, 1-200 characters, in the market's language (table, canapé, sofa, bank, divano). A keyword that names a category answers that category (redirected_to).

Example: table

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.

Example: nl

pageintegerdefault:1

Results page, 1-based, 40 items per page, up to 250 (the site lists at most 250 pages). A page past the last returns no items and a note.

Example: 2

sortenum<string>default:relevance

Result order. The site has no newest, best-seller or discount sort. A sort the site did not apply is reported in notes.

Example: price_asc

relevance — The site's recommended order. The default.
price_asc — Price, low to high.
price_desc — Price, high to low.
rating — Customer rating.

price_minnumber

Lowest price, in the market's currency.

Example: 100

price_maxnumber

Highest price, in the market's currency.

Example: 500

on_saleboolean

Only discounted items.

Example: true

min_discountinteger

Only items at least this many percent off: 20, 30, 40 or 50.

Example: 40

in_stockboolean

Only items in stock online.

Example: true

min_ratinginteger

Customer rating: 5 (five stars only), 4 or 3 (that many stars and up).

Example: 4

colorstring | string[]

1 to 5 color option ids from the answer's facets (facet c).

Example: n9660c0e9e5310638a19012509703a483cebdb2b

materialstring | string[]

1 to 5 material option ids (facet f).

Example: nb8ebc86a80d334b9b406d1550e82ed18f33a77f

stylestring | string[]

1 to 5 style option ids (facet st).

Example: c56c1d2a7f9948cc83b776aed8b5c477

brandstring | string[]

1 to 5 brand option ids (facet bra).

Example: BRAND_MAISONS_DU_MONDE

sellerstring

One marketplace seller's items: seller.code from the seller endpoint or a Seller facet (se) option id. fr, de, es and it only; send seller or sold_by, not both.

Example: BESTMOBILIER

sold_byenum<string>

mdm: only items sold by Maisons du Monde itself, not by marketplace sellers. fr, de, es and it only (on the other markets every item is).

Example: mdm

mdm — Items sold by Maisons du Monde.

filtersobject

Any other facet of the answer, keyed by facets[].id with facets[].options[].id values ({"nbs": ["CAPACITY_2_places"]}); dimension ranges (dd, dh, dw) as "min-max" in cm. At most 10 keys, 5 values each.

Example: {"nbs": ["CAPACITY_2_places"]}

Request

from scavio import ScavioClient

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

# Discounted tables on maisonsdumonde.com France, cheapest first.
r = client.maisonsdumonde.search(query="table", country="fr", on_sale=True, sort="price_asc")["data"]
print(r["total"], "results")
for i in r["items"]:
    print(i["id"], i["name"], i["price"], "was", i["was_price"], i["discount_percent"], i["sold_by"])

Response

"query": "table",

"count": 40,

"sponsored_count": 0,

"total": 51822,

"page": 1,

"page_size": 40,

"total_pages": 75,

"sort": "relevance",

"requested_filters": {},

"applied_filters": [],

"redirected_to": null,

"country": "fr",

"language": "fr",

"currency": "EUR"

"response_time": 3714

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key", timeout=120) # Discounted tables on maisonsdumonde.com France, cheapest first. r = client.maisonsdumonde.search(query="table", country="fr", on_sale=True, sort="price_asc")["data"] print(r["total"], "results") for i in r["items"]: print(i["id"], i["name"], i["price"], "was", i["was_price"], i["discount_percent"], i["sold_by"])