manomano.fr APImanomano.fr ↗
Search ManoMano.fr by keyword and retrieve product details including price, brand, EAN, variants, images, and seller data via two structured endpoints.
curl -X GET 'https://api.parse.bot/scraper/4211615d-af15-45d3-9eda-48b355382937/search_products?page=0&limit=5&query=perceuse' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products on ManoMano.fr using keywords. Returns paginated results from the Algolia search index with product summaries including price, brand, seller, and category.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number, starting from 0. |
| limit | integer | Number of results per page. |
| queryrequired | string | Search keyword (e.g. 'perceuse', 'robinet', 'peinture'). |
{
"type": "object",
"fields": {
"page": "integer current page number",
"limit": "integer results per page",
"total": "integer total number of matching products",
"products": "array of product summary objects with product_id, title, brand, price, url, seller, category, rating, and is_in_stock"
},
"sample": {
"data": {
"page": 0,
"limit": 5,
"total": 10674,
"products": [
{
"url": "https://www.manomano.fr/p/plomberie-douchette-basic-chrom-161415-53041365",
"brand": "PLOMBERIE",
"price": 12.7,
"title": "Plomberie - Douchette Basic Chromé - 161415",
"rating": null,
"seller": "Outillage online",
"category": "Pommeau de douche",
"currency": "EUR",
"model_id": 55149593,
"image_url": "https://cdn.manomano.com/plomberie-douchette-basic-chrome-161415-P-13143-2569426_1.jpg",
"product_id": "2569426",
"is_in_stock": true,
"rating_count": 0,
"retail_price": null
}
]
},
"status": "success"
}
}About the manomano.fr API
The ManoMano.fr API provides two endpoints — search_products and get_product_details — to query and extract structured data from France's leading DIY and home improvement marketplace. A keyword search returns paginated results with 9 fields per product including title, brand, price, seller, category, and stock status. The detail endpoint adds EAN barcodes, image arrays, model variants, and full pricing in EUR.
Search Products
The search_products endpoint accepts a required query string (e.g. perceuse, robinet, peinture) and optional page and limit parameters for pagination. Results start at page 0. Each response includes a total count of matching products alongside an array of summaries. Every product summary carries product_id, title, brand, price, url, seller, category, rating, and is_in_stock — enough to build a results grid, run price comparisons, or monitor stock availability across sellers.
Product Details
The get_product_details endpoint takes the full url returned by search_products and returns a richer payload. Key fields include ean (EAN barcode, or null if unavailable), price (VAT-inclusive EUR), images (array of image URLs), model_id, brand, seller, currency, and a variants array where each variant exposes its own model_id and attributes. This makes it straightforward to map out product configurations — different sizes, colors, or kit options — without additional lookups.
Coverage and Scope
ManoMano.fr lists products across DIY, garden, construction, and home improvement categories from multiple third-party sellers. The seller field in both endpoints identifies the marketplace vendor, and is_in_stock in search results reflects current availability. Prices are returned inclusive of French VAT (TVA) and denominated in EUR. The ean field is returned when the product listing carries a barcode, otherwise it returns null.
- Monitor price changes for specific tools or materials across ManoMano.fr sellers using
search_productswith a recurring keyword query. - Build a product catalog for DIY e-commerce by extracting
title,brand,images, andeanfromget_product_details. - Compare seller listings for the same product by cross-referencing
sellerandpricefields from search results. - Track in-stock availability of construction materials using the
is_in_stockfield fromsearch_products. - Aggregate product variant data by parsing the
variantsarray fromget_product_detailsto map model configurations. - Feed a price comparison tool with VAT-inclusive EUR prices and EAN barcodes to match ManoMano listings against other French retailers.
- Enrich an internal product database with
category,rating, andbrandmetadata retrieved from keyword searches.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does ManoMano have an official developer API?+
What does the `get_product_details` endpoint return beyond what search provides?+
ean, images (an array of image URLs), model_id, currency, and a variants array with per-variant model_id and attributes. The search endpoint gives a flatter summary — title, brand, price, seller, category, rating, and stock status — but does not include variant breakdowns or image arrays.How does pagination work in `search_products`?+
page=0 returns the first page. The limit parameter controls results per page, and the total field in the response gives the overall count of matching products so you can calculate how many pages exist for a given query.Are customer reviews or seller ratings returned by either endpoint?+
search_products endpoint returns a rating field at the product level. Detailed review text, individual review counts, or per-seller ratings beyond the product rating are not currently returned by either endpoint. You can fork this API on Parse and revise it to add a reviews endpoint if your use case requires that data.