Maisons du Monde

Maisons du Monde Deals API

A Maisons du Monde sale event's products, 40 per page: black_friday (the default, on every market while it runs) or second_chance (fr only: used and returned items with their condition), or any category's discounted items (category / category_url, optionally with min_discount). Each item has price, the crossed-out was_price, percent off, badges and who sells it, with the search sorts and filters. Costs 1 credit per request.

POST/api/v1/maisonsdumonde/deals

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

eventenum<string>default:black_friday

The sale event. Or send category / category_url instead for that category's discounted items (not both).

Example: black_friday

black_friday — Black Friday, on every market while it runs. The default.
second_chance — Seconde Chance: used and returned items with their condition. fr only.

categorystring

A category hash: answers its discounted items (on_sale unless min_discount is sent).

Example: canapes-n4dc562d7bb509362a3a2102db4cbf90b6454f1f

category_urlstring

A category page of any market: answers its discounted items.

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)

# Black Friday on the Spanish site, 50% off and more, sold by Maisons du Monde.
r = client.maisonsdumonde.deals(event="black_friday", country="es", min_discount=50, sold_by="mdm")["data"]
print(r["event"]["name"], r["total"])
for i in r["items"]:
    print(i["id"], i["name"], i["price"], "was", i["was_price"], i["discount_percent"])

Response

"count": 40,

"sponsored_count": 16,

"total": 107344,

"page": 1,

"page_size": 40,

"total_pages": 250,

"sort": "relevance",

"requested_filters": {},

"applied_filters": [],

"country": "fr",

"language": "fr",

"currency": "EUR"

"response_time": 1813

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key", timeout=120) # Black Friday on the Spanish site, 50% off and more, sold by Maisons du Monde. r = client.maisonsdumonde.deals(event="black_friday", country="es", min_discount=50, sold_by="mdm")["data"] print(r["event"]["name"], r["total"]) for i in r["items"]: print(i["id"], i["name"], i["price"], "was", i["was_price"], i["discount_percent"])