Maisons du Monde API
Maisons du Monde product data as structured JSON: the promo price next to the crossed-out price and percent off, badges such as BLACK FRIDAY, whether Maisons du Monde or a marketplace seller sells each item, exact online stock, reviews pooled across markets and translated, Black Friday and Seconde Chance grids, store stock counts and the delivery from-price. France, Belgium, Luxembourg, the Netherlands, Germany, Spain, Italy and Portugal in EUR, and Switzerland in CHF.
50 free credits on signup. No card, no seller account.
{ "data": { "query": "table", "items": [ { "position": 1, "id": "166560", "name": "Table à manger extensible, L160/230 cm", "collection": "Bronx", "brand": "Maisons du Monde", "url": "https://www.maisonsdumonde.com/FR/fr/p/table-a-manger-extensible-l160-230-cm-bronx-166560.htm", "image": "https://medias.maisonsdumonde.com/images/f_auto,q_auto,w_350/v1/img/166560_0/table-a-manger-extensible-l160-230-cm-bronx.jpg", "price": 319.2, "was_price": 399, "discount_percent": 20, "currency": "EUR", "badges": [ "BLACK FRIDAY" ], "rating": 4.08, "review_count": 304, "color_count": null, "sold_by": "mdm", "offer_id": null, "sponsored": false, "condition": null, "store_only": false, "purchase_status": "purchasable" }, "… 39 more (trimmed for preview)" ], "count": 40, "sponsored_count": 0, "total": 51822, "page": 1, "page_size": 40, "total_pages": 75, "sort": "relevance", "sorts_offered": [ { "sort": "relevance", "label": "Notre recommandation" }, "… 3 more (trimmed for preview)" ], "requested_filters": {}, "applied_filters": [], "facets": [ { "id": "cmdm", "name": "Marque Maisons du Monde", "type": "options", "options": [ { "id": "COLL_MDM_COLL_MAISONSDUMONDE", "label": "Marque Maisons du Monde", "count": 2614 } ], "option_count": 1 }, "… 27 more (trimmed for preview)" ], "redirected_to": null, "country": "fr", "language": "fr", "currency": "EUR" }, "response_time": 3714}Live calls against the real endpoints on maisonsdumonde.com France. 3 free runs across every tab, then it's your own key.
What is the Scavio Maisons du Monde API?
The Scavio Maisons du Monde API is a REST API that returns Maisons du Monde product, promo price, review, deal, store stock and marketplace seller data as JSON for 9 countries in 6 languages. Each price comes with the crossed-out price, percent off and who sells the item. Every call costs 1 credit.
- 9
- endpoints, all live in production
- 9
- markets: fr, be, lu, nl, de, es, it, pt, ch
- 1
- credit per call, every endpoint and market
The Maisons du Monde data buyers actually need
What an item costs now, what it cost before the promotion, who sells it, what it costs on each storefront, and whether the store near you has it.
Promo price next to the crossed-out price
POST /api/v1/maisonsdumonde/searchprice, was_price and discount_percent on every item, with the BLACK FRIDAY badge. The Bronx extendable table on 2026-11-14: 319.20 EUR, was 399, 20% off.
One product id on every storefront
POST /api/v1/maisonsdumonde/productThe same id works on all 9 markets, and prices can differ by market: on about 170 sofas measured 2026-11-14, Belgium differed from France on 19, and Switzerland is priced separately in CHF.
Maisons du Monde or a marketplace seller
POST /api/v1/maisonsdumonde/categorysold_by on every item and sponsored marketplace tiles flagged; filter to sold_by mdm or to one seller on fr, de, es and it.
Black Friday and Seconde Chance
POST /api/v1/maisonsdumonde/dealsThe Black Friday grid on every market while it runs, Seconde Chance used and returned items in France, or any category's discounted items.
Reviews pooled across markets, translated
POST /api/v1/maisonsdumonde/reviewsStar histogram, style, value-for-money and comfort scores, and the market each review was written in. The Nio sofa bed: 830 reviews, 4.07.
Stock count at one store
POST /api/v1/maisonsdumonde/availabilityquantity, the site's stock text and whether only the display piece is in store, for one item at one store id.
Delivery from-price
POST /api/v1/maisonsdumonde/availabilityHome delivery, store pickup and in-store options with the from-price per product and market: "à partir de 6,90 €" for the round mirror in France.
Stores and opening hours
POST /api/v1/maisonsdumonde/storesThe 10 stores nearest a postcode with distance and hours, then each store's phone and services: 10 stores near Paris 75011.
All 9 Maisons du Monde API endpoints
Every route is a POST, returns JSON and takes the same API key. Credits are charged per successful call and per not-found; a 400 and failed upstream calls are not charged.
| Endpoint | Returns | Credits |
|---|---|---|
Search/api/v1/maisonsdumonde/search | Keyword search on any of the 9 markets, 40 a page with the exact total: price, crossed-out was_price, percent off, badges, rating and whether Maisons du Monde or a marketplace seller sells each item | 1 |
Product/api/v1/maisonsdumonde/product | One product by id or URL: price, was_price, exact online stock, variants with their price difference, dimensions, materials, seller, review summary, Q&A and the product's URL on every other market | 1 |
Category/api/v1/maisonsdumonde/category | One category by hash or URL (the same hash on every market), 40 a page, with price and rating sorts, discount, seller and facet filters | 1 |
Deals/api/v1/maisonsdumonde/deals | The Black Friday grid on every market while it runs, Seconde Chance used and returned items (fr), or any category's discounted items | 1 |
Reviews/api/v1/maisonsdumonde/reviews | A product's reviews pooled across markets and translated into the request language: star histogram, criteria scores, brand replies, 1 to 30 a page with a cursor | 1 |
Stores near a postcode/api/v1/maisonsdumonde/stores | Up to 10 stores nearest a postcode with address, coordinates, distance, opening hours and click and collect (fr, be, de, es, it, pt, ch) | 1 |
Store/api/v1/maisonsdumonde/store | One store: address, phone, hours for every day, services and click and collect level | 1 |
Store stock/api/v1/maisonsdumonde/availability | One item's stock count at one store, the site's stock text, the display-model flag and the home delivery from-price | 1 |
Marketplace seller/api/v1/maisonsdumonde/seller | A marketplace seller's rating, orders, member-since date, shipping and returns policy, plus its catalogue at 40 items a page (fr, de, es, it) | 1 |
50 free credits on signup covers 50 calls on any market. See plans
9 markets, 6 languages, 2 currencies
One country parameter, plus language on Belgium and Switzerland. Names come in the storefront's language; every answer echoes country, language and currency.
| country | Market | Language(s) | Currency | Marketplace sellers | Endpoints |
|---|---|---|---|---|---|
| fr (default) | France | French | EUR | yes | All 9 |
| be | Belgium | French (default) or Dutch | EUR | no | All except seller |
| lu | Luxembourg | French | EUR | no | Search, product, category, deals, reviews |
| nl | Netherlands | Dutch | EUR | no | Search, product, category, deals, reviews |
| de | Germany | German | EUR | yes | All 9 |
| es | Spain | Spanish | EUR | yes | All 9 |
| it | Italy | Italian | EUR | yes | All 9 |
| pt | Portugal | Portuguese | EUR | no | All except seller |
| ch | Switzerland | French (default), German or Italian | CHF | no | All except seller |
1 credit per call on every market. The store finder returns no stores on nl and lu, so stores, store and availability serve the other 7. Marketplace sellers exist on fr, de, es and it only. Maisons du Monde closed in the UK in 2023 and its Austrian store in 2026: at, gb and uk answer 400, not charged.
Promo prices across storefronts
The same product id read on each Maisons du Monde storefront on 2026-11-14, one call per market. Prices as each storefront showed them, never converted.
| Product (id) | Euro storefronts read | Euro price | Switzerland (ch) |
|---|---|---|---|
| Round gold steel mirror D80 (204172) | fr, be, lu, nl, de, es, it, pt | 37.45 EUR, was 74.99 (50% off) | 45.95 CHF, was 91.90 |
| Open compressed 3-seater sofa (254909) | fr, be, lu, nl, de, es, it, pt | 479.20 EUR, was 599 (20% off) | 527.20 CHF, was 659 |
| Nio 2-seater sofa bed (186339) | fr, be, lu, nl, de, es, it, pt | 339 EUR | 339 CHF |
| Sheesham coffee table L100 (129991) | fr, nl, de, es, it, pt | 271.20 EUR, was 339 (20% off) | not sold on ch |
| Nuage right-corner sofa, 4/5 seats (230448) | be, lu | 1,699 EUR | 1,699 CHF (fr and it) |
| 3/4-seater chaise sofa, beige (166180) | es, it, pt | 199.50 EUR, was 399 (50% off) | not read |
Readings on 2026-11-14 on 6 products; they are examples, not a rule. Prices can differ by market: on about 170 discounted sofas measured the same day, Luxembourg, the Netherlands, Germany, Spain, Italy and Portugal matched France on every item, Belgium differed on 19 (e.g. 238617: 449.50 EUR on fr, 399.50 on be), and Switzerland is priced separately in CHF. Read each market you report, and store product id, currency and fetched_at with every reading. eco_participation (the French furniture recycling fee, e.g. 18.50 EUR on the Open sofa) is included in the price and shown on fr only.
What the page shows, and what the API returns
Every price is a number in the market's currency. The API returns what the storefront shows and nothing it does not.
| On the page | In the API |
|---|---|
| Price shown now | price |
| Crossed-out price next to a discount | was_price (null when there is no discount) |
| Percent off | discount_percent (the page's own figure) |
| BLACK FRIDAY, Nouveau, Seconde Chance flags | badges |
| Eco-participation (France) | eco_participation, included in price |
| Sold by Maisons du Monde or a marketplace seller | sold_by (mdm or marketplace); seller { name, rating, orders, member_since } on product |
| Sponsored marketplace tiles | sponsored true, not counted in count |
| Home delivery "from" price | delivery[].from_price on availability (per product and market, not per postcode) |
| EU 30-day lowest price | Not shown on Maisons du Monde pages, so not returned |
Maisons du Monde shows no price history either. To build one, poll the same product id on a schedule and store price, was_price, badges, currency and fetched_at.
Read a Maisons du Monde promo on every storefront
A promo tracker reads price next to the crossed-out was_price for one product id on each market and keeps the currency with every reading. The response on the right is a real search capture from maisonsdumonde.com France.
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key", timeout=120)
# One product id on every storefront: the promo price next to the crossed-out price.
markets = [("fr", "fr"), ("be", "nl"), ("lu", "fr"), ("nl", "nl"), ("de", "de"),
("es", "es"), ("it", "it"), ("pt", "pt"), ("ch", "de")]
for country, language in markets:
p = client.maisonsdumonde.product(id="204172", country=country, language=language)["data"]
print(country, p["price"], "was", p["was_price"], p["discount_percent"], p["currency"], p["sold_by"]){
"data": {
"query": "table",
"items": [
{
"position": 1,
"id": "166560",
"name": "Table à manger extensible, L160/230 cm",
"collection": "Bronx",
"brand": "Maisons du Monde",
"url": "https://www.maisonsdumonde.com/FR/fr/p/table-a-manger-extensible-l160-230-cm-bronx-166560.htm",
"image": "https://medias.maisonsdumonde.com/images/f_auto,q_auto,w_350/v1/img/166560_0/table-a-manger-extensible-l160-230-cm-bronx.jpg",
"price": 319.2,
"was_price": 399,
"discount_percent": 20,
"currency": "EUR",
"badges": [
"BLACK FRIDAY"
],
"rating": 4.08,
"review_count": 304,
"color_count": null,
"sold_by": "mdm",
"offer_id": null,
"sponsored": false,
"condition": null,
"store_only": false,
"purchase_status": "purchasable"
},
{
"position": 2,
"id": "110279",
"name": "Table à manger en bois de sheesham massif, L160 cm",
"collection": "Stockholm",
"brand": "Maisons du Monde",
"url": "https://www.maisonsdumonde.com/FR/fr/p/table-a-manger-en-bois-de-sheesham-massif-l160-cm-stockholm-110279.htm",
"image": "https://medias.maisonsdumonde.com/images/f_auto,q_auto,w_350/v1/img/110279/table-a-manger-en-bois-de-sheesham-massif-l160-cm-stockholm.jpg",
"price": 499,
"was_price": null,
"discount_percent": null,
"currency": "EUR",
"badges": [],
"rating": 4.64,
"review_count": 183,
"color_count": null,
"sold_by": "mdm",
"offer_id": null,
"sponsored": false,
"condition": null,
"store_only": false,
"purchase_status": "purchasable"
}
],
"count": 40,
"sponsored_count": 0,
"total": 51822,
"page": 1,
"page_size": 40,
"total_pages": 75,
"sort": "relevance",
"sorts_offered": [
{
"sort": "relevance",
"label": "Notre recommandation"
},
{
"sort": "price_asc",
"label": "Prix croissant"
},
{
"sort": "price_desc",
"label": "Prix décroissant"
},
{
"sort": "rating",
"label": "Avis client"
}
],
"requested_filters": {},
"applied_filters": [],
"facets": [
{
"id": "c",
"name": "Couleur",
"type": "options",
"options": [
{
"id": "n8eea815d46c86aea00d428dc2c0371f4e3233a3",
"label": "Marron",
"count": 8166
},
{
"id": "n2933406e0a3de7ee83fc2b592f0fdfcf06b21b8",
"label": "Blanc",
"count": 6410
},
{
"id": "nfb0eeb5bcae2989408a89b7f051343cc0df79b9",
"label": "Noir",
"count": 6048
}
],
"option_count": 18
},
{
"id": "p",
"name": "Prix",
"type": "range",
"min": 2,
"max": 1299
},
{
"id": "disc",
"name": "Taux de réduction",
"type": "options",
"options": [
{
"id": "all",
"label": "Toutes les promotions",
"count": 22698
},
{
"id": "20-100",
"label": "-20% et plus",
"count": 14970
},
{
"id": "30-100",
"label": "-30% et plus",
"count": 10234
},
{
"id": "40-100",
"label": "-40% et plus",
"count": 7985
},
{
"id": "50-100",
"label": "-50% et plus",
"count": 5824
}
],
"option_count": 5
},
{
"id": "se",
"name": "Vendeur",
"type": "options",
"options": [
{
"id": "MAISONS-DU-MONDE",
"label": "Maisons du Monde",
"count": 2614
},
{
"id": "HOME-PARTNERS-FRANCE",
"label": "Home Partners France",
"count": 1680
},
{
"id": "GAMUSI",
"label": "Gamusi",
"count": 1344
}
],
"option_count": 286
}
],
"redirected_to": null,
"country": "fr",
"language": "fr",
"currency": "EUR"
},
"response_time": 3714
}Why not an official Maisons du Monde API?
Maisons du Monde's API access is built for its marketplace sellers. Here is what it covers, and where the Scavio API fits.
Maisons du Monde marketplace seller API
- For approved third-party marketplace sellers
- Publishes and updates a seller's own products, offers and stock
- No public product or price API for the Maisons du Monde catalogue
- Product feeds go to approved affiliates through affiliate networks
Scavio Maisons du Monde API
- One Scavio key issued at signup, 1 credit per call
- Promo price, crossed-out price and percent off in 9 countries
- Maisons du Monde and marketplace items, with seller profiles
- Reviews pooled across markets, translated, with cursor paging
- Store stock counts, stores with hours and the delivery from-price
- The same JSON envelope and key as every other Scavio platform
Maisons du Monde facts from its seller support pages and corporate site, read 2026-11-14. Not legal advice.
What developers build with it
Promo price trackers for Maisons du Monde
Poll a watch list of product ids daily, store price, was_price and discount_percent, and alert when an item goes on promotion or its discount deepens.
product + searchCross-border price comparison
Read one product id on every storefront and keep the currency with each reading: the euro markets side by side, Switzerland in CHF.
productBlack Friday and soldes monitoring
Read the Black Friday grid every day of the event, and category discounts through the French winter soldes (January 6 to February 2, 2027).
deals + categoryEuropean furniture price benchmarking
Track a category's prices and discounts next to IKEA, Wayfair or your own catalogue, filtered by color, material, style or price range.
category + searchMarketplace seller intelligence
See which items Maisons du Monde sells itself and which come from marketplace sellers, and read each seller's rating, orders and catalogue.
seller + categoryReview monitoring across markets
Watch the rating histogram and the newest reviews of a product line, with the market each review was written in and the brand's replies.
reviewsStore stock checkers
Find the stores near a postcode, then check one item's stock count at each and whether only the display piece is left.
stores + availabilityShopping agents and assistants
Give an AI agent Maisons du Monde as tools: find a table, read its promo price and reviews in the shopper's language, and find the nearest store with stock.
MCP + RESTHow to track Maisons du Monde promo prices
- 1
Get an API key
Sign up for a Scavio account and copy your key from the dashboard. You get 50 free credits on signup (50 calls), with no card.
- 2
Search a storefront
Send {"query": "table", "country": "fr"} to https://api.scavio.dev/api/v1/maisonsdumonde/search with an Authorization: Bearer header. Each item carries its id, price, was_price, discount_percent and sold_by. Search in the market's language: canapé on fr, bank on nl, sofa on de.
- 3
Read the product on each market
Send {"id": "204172", "country": "de"} to /api/v1/maisonsdumonde/product for price, the crossed-out price, stock and variants. The same id works on every market; markets[] lists the product's URL on each.
- 4
Poll and store each reading
Run the same calls on a schedule and store price, was_price, badges, currency and fetched_at. Maisons du Monde shows no price history or 30-day lowest price, so your readings are the record.
Maisons du Monde API FAQ
Does Maisons du Monde have a public API?
+
Not for product or price data. Maisons du Monde publishes no public product or price API. Its marketplace runs a seller API for approved third-party sellers, who use it to publish and update their own products, offers and stock, and product feeds go to approved affiliates through affiliate networks. The Scavio Maisons du Monde API is a separate option: 9 POST endpoints on one API key, with no seller or affiliate account.
What is the crossed-out price, and how do I read a Maisons du Monde promo?
+
price is what the storefront charges now; was_price is the crossed-out price the page shows next to a discount (null when there is none); discount_percent is the page's own percent off, and badges carries flags such as BLACK FRIDAY. On 2026-11-14 the Bronx extendable dining table 166560 was 319.20 EUR on maisonsdumonde.com France, was 399, 20% off. Maisons du Monde Search API docs
Does it return the EU 30-day lowest price?
+
No. Maisons du Monde pages do not show a 30-day lowest price, so the API does not return one; was_price is the site's crossed-out price as shown. If you need a lowest-price record, poll the product and keep your own history.
Are Maisons du Monde prices different in each country?
+
Sometimes. Prices are in the market's currency, never converted. Measured on 2026-11-14 on about 170 discounted sofas sold by Maisons du Monde, matched by product id against France: Luxembourg, the Netherlands, Germany, Spain, Italy and Portugal matched France on every item; Belgium differed on 19 of 170 (18 lower, 1 higher: 238617 was 449.50 EUR in France and 399.50 in Belgium, 234542 was 799.20 in France and 1,039.20 in Belgium); discount_percent never differed; and Switzerland is priced separately in CHF (of 165 sofas, 111 showed the same number in CHF as in EUR, 54 were 9-10% higher). Some items read the same everywhere: the round gold mirror 204172 was 37.45 EUR, was 74.99, on every euro market and 45.95 CHF, was 91.90, in Switzerland. Read each market you report, and store the currency and date with every reading.
Which markets and languages are covered?
+
9 markets: France (French), Belgium (French or Dutch), Luxembourg (French), the Netherlands (Dutch), Germany (German), Spain (Spanish), Italy (Italian) and Portugal (Portuguese) in EUR, and Switzerland (French, German or Italian) in CHF. Send country and, on Belgium and Switzerland, language. Maisons du Monde reported 328 stores at the end of 2025 in 8 countries; it closed in the UK in 2023 and its Austrian store in 2026, so at and gb are not served.
Are reviews per country?
+
No. Maisons du Monde pools reviews across every market and shows them translated into the request language, so the same product returns the same reviews on fr, de or ch. Each review carries source_market, the market it was written in, plus its rating, text, date, criteria scores (style, value for money, comfort) and the brand's reply. Pages of 1 to 30 with a cursor; there is no star filter. Maisons du Monde Reviews API docs
How do I tell Maisons du Monde items from marketplace sellers?
+
Every grid item has sold_by: mdm or marketplace (marketplace ids start with M), and sponsored marketplace tiles are flagged. On fr, de, es and it you can filter to sold_by mdm or to one seller's code. Grid tiles do not name the seller: the product endpoint returns the seller's name, rating, orders and member-since date, and the seller endpoint its full profile and catalogue.
Can I check stock at a Maisons du Monde store?
+
Yes, on fr, be, de, es, it, pt and ch. Find the store id with stores (the 10 nearest a postcode), then call availability with the item id and store id: it returns in_stock, the store's stock count, the site's stock text and whether only the display piece is in store. Marketplace items ship from their seller and are not stocked in stores.
Does it return the delivery cost?
+
It returns the home delivery from-price per product and market, as the site shows it ("à partir de 6,90 €" for the round mirror 204172 in France on 2026-11-14), plus store pickup and in-store options. The exact cost for a postcode is only shown in the cart, so it is not returned.
How do I track Maisons du Monde's Black Friday and soldes prices?
+
Black Friday 2026 is November 27, and the Black Friday grid is on the deals endpoint on every market while it runs. The French winter soldes run from January 6 to February 2, 2027: read the categories you watch with on_sale or min_discount. Poll daily and store price, was_price and discount_percent each time.
Does it return Maisons du Monde price history?
+
No. Maisons du Monde shows no price history and no endpoint returns one. Poll the product (or a category or deals grid) on a schedule and store each reading; 100 products on two markets read daily is about 6,000 credits a month.
What do Maisons du Monde's terms say?
+
Maisons du Monde's terms reserve its rights over the site's content, including database rights, and prohibit reproducing or using it without its prior consent; they allow downloading copies for personal, non-commercial use. We do not interpret them for you: read the current terms for your use case. You are responsible for your own compliance. This is not legal advice.
How much does a Maisons du Monde request cost?
+
1 credit per call on every endpoint and market. New accounts get 50 free credits on signup, one time and with no card. Paid plans start with Hobby at $15 per month for 3,000 credits; on Growth credits cost $1 per 1,000, so a call costs $0.001. A 400 and a failed upstream call are not charged; a not-found is charged.
How fresh is the data, and how long does a call take?
+
Every request reads Maisons du Monde when you call it and carries fetched_at; nothing is cached. Search, product, category, deals and seller usually answer in 2 to 25 seconds; reviews, stores, store and availability usually in 2 to 45 seconds and occasionally over a minute. Set a client timeout of 120 seconds.
Explore more of Scavio
Best Maisons du Monde promo price APIs
Five options priced, plus 172 discounted sofas compared across 9 countries.
How to get Maisons du Monde promo prices
Search, product, cross-country prices, sellers, Black Friday and a daily poll, step by step.
How often does Maisons du Monde have sales?
The 2026-2027 sales calendar and a Black Friday snapshot of six categories.
IKEA API
IKEA prices by country, product detail and store stock in 55 markets.
Wayfair API
Wayfair prices with sale and was price, option prices and reviews.
Ashley Furniture API
Ashley prices next to the Regular Price, with the price zone.
Decathlon API
Product search, pricing and availability across 7 country stores.
Carrefour API
Carrefour France product and price data.
Allegro API
Allegro offers, prices and sellers in Poland, Czechia, Slovakia and Hungary.
Amazon API
Search, product and offers across 22 marketplaces.
Maisons du Monde API docs
All 9 endpoints with params and real responses.
Try the Maisons du Monde API free
50 free credits on signup, no card. Your first request is a POST with a product id, or a search for anything Maisons du Monde sells.