Maisons du Monde

Maisons du Monde Category API

One Maisons du Monde category's products by category hash or category URL, on any of its 9 markets: 40 per page with the exact total, the search sorts (relevance, price, customer rating) and filters (price range, discount, stock, rating, color, material, style, brand, marketplace seller, sold by Maisons du Monde, any facet), and facets with counts. The category hash is the same on every market, so a URL from one market works on any other. Costs 1 credit per request.

POST/api/v1/maisonsdumonde/category

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

categorystring

A category hash (the end of a /c/ URL, the same on every market), optionally with its name, or redirected_to.category_id of a search. Send category or category_url.

Example: canapes-n4dc562d7bb509362a3a2102db4cbf90b6454f1f

category_urlstring

A category page of any market; filters in it are kept. Fetched on country / language when sent, else on the URL's own market.

Example: https://www.maisonsdumonde.com/FR/fr/c/canapes-n4dc562d7bb509362a3a2102db4cbf90b6454f1f

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)

# Sofas sold by Maisons du Monde itself (no marketplace), 40% off and more.
r = client.maisonsdumonde.category(
    category="canapes-n4dc562d7bb509362a3a2102db4cbf90b6454f1f",
    country="fr", sold_by="mdm", min_discount=40,
)["data"]
print(r["category"]["name"], r["total"])
for i in r["items"]:
    print(i["id"], i["name"], i["price"], i["was_price"], i["discount_percent"])

Response

"count": 40,

"sponsored_count": 16,

"total": 18337,

"page": 1,

"page_size": 40,

"total_pages": 250,

"sort": "relevance",

"requested_filters": {},

"applied_filters": [],

"country": "fr",

"language": "fr",

"currency": "EUR"

"response_time": 1051

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key", timeout=120) # Sofas sold by Maisons du Monde itself (no marketplace), 40% off and more. r = client.maisonsdumonde.category( category="canapes-n4dc562d7bb509362a3a2102db4cbf90b6454f1f", country="fr", sold_by="mdm", min_discount=40, )["data"] print(r["category"]["name"], r["total"]) for i in r["items"]: print(i["id"], i["name"], i["price"], i["was_price"], i["discount_percent"])