Monoprix API & Scraper
Monoprix sells its supermarket range online at courses.monoprix.fr.
🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.
`search` returns products for a term with the EUR shelf price, price per kg or litre, the promotion texts the site shows ("-30% remise immédiate", "-60% sur le 2ème produit", "2 +1 offert"), availability, brand, pack size and dietary labels, plus brand and promotion facets; `category` browses an aisle, `categories` lists the aisle tree, and `product` returns the full sheet: description, ingredients, allergens, packaging, manufacturer address, storage and the nutrition table. Monoprix uses one national price list: a Lyon and a Paris address returned the same prices for 31 of 31 shared products, while the range differs by area, so latitude/longitude are accepted and the answer says which region it used.
What a Monoprix field actually contains
Fields that read differently from how they look. Every row was measured against live responses on 2026-10-18.
| Field | What it holds |
|---|---|
| price, currency | The shelf price printed on the product page, in euros. Checked against the page for 8 of 8 products in each of two runs. |
| promotions | The site's own promotion texts. "-x% sur le 2ème produit" and "2 +1 offert" are basket rules: the shelf price stays the shelf price, and the API does not compute a discounted price for you. |
| unit_price, unit | Price per kg or per litre as printed (Camembert 250 g: 11.16 per kg). |
| price_is_estimate, typical_weight | Cheese and meat sold by weight: the price is for a typical 200 g piece. |
| ingredients, allergens, fields | The label text as published ("Lait" / "LAIT"), plus packaging, manufacturer and storage fields. |
| gtin | Monoprix does not print barcodes on its product sheets (0 of 8), so the field stays null; MPX_6600978 is Monoprix's own id. |
Monoprix publishes no total count for a search; total is filled only when the first page is the whole answer.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/monoprix/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"query": "lait",
"limit": 24
}
}{
"ok": true,
"meta": {
"api": "monoprix",
"endpoint": "search",
"mode": "live",
"latency_ms": 1013.5,
"record_count": 24,
"bytes": 368188,
"cache_hit": false,
"upstream_requests": 1,
"warnings": [
"Unknown parameter ignored: include_pii"
],
"charged_credits": 3,
"version": "1.0.0",
"request_id": "cc0cda1a2a0943a5",
"queue_ms": 1.7,
"fetched_at": "2026-10-18T17:45:01.962Z"
},
"data": {
"products": [
{
"id": "MPX_875909",
"product_uuid": "3c95bf82-e735-4411-85f6-cf2a59e5207f",
"title": "Monoprix Lait Demi Écrémé 6x1L",
"brand": "Monoprix",
"pack_size": "6 x 1L",
"price": 6.49,
"currency": "EUR",
"unit_price": 1.08,
"unit": "litre",
"promo_price": null,
"promo_unit_price": null,
"lowest_price_30d": null,
"deposit_price": null,
"price_is_estimate": false,
"typical_weight": null,
"available": true,
"max_available_quantity": null,
"in_current_catalog": true,
"is_new": false,
"alcohol": false,
"promotions": [],
"dietary_labels": [],
"category_path": [
"Mes marques Monoprix",
"Monoprix",
"Produits Frais"
],
"rating": null,
"review_count": null,
"seller": null,
"sponsored": false,
"image": "https://courses.monoprix.fr/images-v3/0c44253f-c4a3-4340-9d37-d41e42b9d14a/f9ff0ec5-0d0c-498e-b88c-0e01f9cbc570/300x300.jpg",
"url": "https://courses.monoprix.fr/products/MPX_875909/details",
"group_type": "personalized"
},
{
"id": "MPX_6600978",
"product_uuid": "521a6785-a60c-447b-9550-64fba043ab29",
"title": "Monoprix Lait frais demi-écrémé 1L",
"brand": "Monoprix",
"pack_size": "1L",
"price": 1.19,
"currency": "EUR",
"unit_price": 1.19,
"unit": "litre",
"promo_price": null,
"promo_unit_price": null,
"lowest_price_30d": null,
"deposit_price": null,
"price_is_estimate": false,
"typical_weight": null,
"available": true,
"max_available_quantity": null,
"in_current_catalog": true,
"is_new": false,
"alcohol": false,
"promotions": [],
"dietary_labels": [],
"category_path": [
"Nos sélections",
"Inspiration du moment",
"& Sélection Petit Déjeuner"
],
"rating": null,
"review_count": null,
"seller": null,
"sponsored": false,
"image": "https://courses.monoprix.fr/images-v3/0c44253f-c4a3-4340-9d37-d41e42b9d14a/3fc357b8-2b50-49fe-9179-99ad470d82ba/300x300.jpg",
"url": "https://courses.monoprix.fr/products/MPX_6600978/details",
"group_type": "personalized"
},
{
"id": "MPX_966137",
"product_uuid": "b35666a7-67ab-4f66-a48d-34d072df8596",
"title": "Monoprix Bio Lait demi-écrémé stérilisée 6x1L",
"brand": "Monoprix Bio",
"pack_size": "6 x 1L",
"price": 7.69,
"currency": "EUR",
"unit_price": 1.28,
"unit": "litre",
"promo_price": null,
"promo_unit_price": null,
"lowest_price_30d": null,
"deposit_price": null,
"price_is_estimate": false,
"typical_weight": null,
"available": true,
"max_available_quantity": null,
"in_current_catalog": true,
"is_new": false,
"alcohol": false,
"promotions": [],
"dietary_labels": [
"Produit bio"
],
"category_path": [
"Bio",
"Boisson et Cave bio",
"Lait bio"
],
"rating": null,
"review_count": null,
"seller": null,
"sponsored": false,
"image": "https://courses.monoprix.fr/images-v3/0c44253f-c4a3-4340-9d37-d41e42b9d14a/4b0799fc-1e54-4f38-a5d8-9aaff4d7842d/300x300.jpg",
"url": "https://courses.monoprix.fr/products/MPX_966137/details",
"group_type": "personalized"
}
],
"returned": 24,
"duplicate_rows_dropped": 0,
"sponsored_rows": 0,
"facets": [
{
"id": "boolean",
"label": "boolean",
"type": "BOOLEAN",
"values": [
{
"id": "[trimmed-depth]",
"label": "[trimmed-depth]"
}
]
},
{
"id": "brands",
"label": "brands",
"type": "BRANDS",
"values": [
{
"id": "[trimmed-depth]",
"label": "[trimmed-depth]"
},
{
"id": "[trimmed-depth]",
"label": "[trimmed-depth]"
},
{
"id": "[trimmed-depth]",
"label": "[trimmed-depth]"
}
]
},
{
"id": "habitudeAlimentaire",
"label": "Habitude alimentaire",
"type": "RETAILER",
"values": [
{
"id": "[trimmed-depth]",
"label": "[trimmed-depth]"
},
{
"id": "[trimmed-depth]",
"label": "[trimmed-depth]"
},
{
"id": "[trimmed-depth]",
"label": "[trimmed-depth]"
}
]
}
],
"sort_options": [
"favorite",
"pricePerAscending",
"pricePerDescending"
],
"has_more": true,
"next_cursor": "eyJ0IjoiNWIwYWYyYzctNDM1NS00NGMwLTk4MTgtYTcyYmEyZGYzNTdiIiwiYyI6IlZJU0lUT1JJRD1tZDZ2b1NJVnNQQTRjTlA4Rk1JZTZLeWE4a3pwYVE5cC1wVnJuaHJLNk9pem95TUdTd08xRnNObnE1WGRTS2gybUZqeThBZnN3TzY0RlNrWXNTZ3FRZlRBdEFVX2x4TlBWLXQtYkE9PTsgZ2xvYmFsX3NpZD1IbGZScm9CeXVHNDhEQjNOVi1pa2NyeS1hNVpYa3k3T3dEQmc5RUVzemFHT1docjRCMGN1Yl90bHdyN2tEQ184TG02Y0tUX3laYmFJOUw5bEM2R01jUWxXd1RjQmtfU3RVTFg1Tnc9PTsgQVdTQUxCPWpPd29XZlV6MndqWFNZbkpZWDNRenJvaDdsRTJ2MUtIckI0N1Z4cEJTUk1qL0c0Q1U1RStCanRKamcyQmRmcFhkMXZGczBCcFRmV2l0Vis1NHdGRFdUOTA5Y29LRmpkUkVnL25lRjYwalRWRDZjU0JVTVd5WG1TOHB3ZU07IEFXU0FMQkNPUlM9ak93b1dmVXoyd2pYU1luSllYM1F6cm9o",
"total": null,
"total_basis": "unknown (source publishes no search total)",
"currency": "EUR",
"location": {
"store_defaulted": true,
"region_name": "France",
"note": "site default region for visitors without a location"
}
}
}What the Monoprix API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | Search the Monoprix online grocery catalogue (EUR). Monoprix courses en ligne, France. | Pricing teams call search to search the Monoprix online grocery catalogue (EUR). | query |
| category | Browse one Monoprix category by its id from categories. | Marketplace operators call category to get browse one Monoprix category by its id from categories.. | category_id |
| product | Full Monoprix product sheet: description, ingredients, allergens, nutrition table, every label field, all images, promotions with terms. | Catalog enrichment teams call product to get full Monoprix product sheet. | id |
| categories | Monoprix category tree (top level and one child level) with the ids the category action takes. | Retail analysts call categories to get monoprix category tree (top level and one child level) with the ids the category action takes.. | none |
Call search from your stack
curl -X POST https://api.reefapi.com/monoprix/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"lait","limit":24}'import requests
r = requests.post(
"https://api.reefapi.com/monoprix/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "lait",
"limit": 24
},
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/monoprix/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"query": "lait",
"limit": 24
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.monoprix.search with {"query":"lait","limit":24}.Who uses this API and why
- Track Monoprix shelf prices and promotions on everyday groceries.
- Compare Paris supermarket prices with other French retailers.
- Collect ingredients, allergens and nutrition tables for French food products.
- Monitor which products are on remise immédiate or multi-buy lots.
- Follow the Monoprix own-brand range by aisle.
Questions developers ask before integrating
Do I need a Monoprix account?
No. Prices, promotions and product sheets are read as a visitor sees them before signing in.
Is there a Monoprix loyalty-card price?
No member price is published on the public site. Promotions come as text; the shelf price is what everyone pays.
Does the price change with the address?
Not in our test: Paris and Lyon addresses returned the same price for 31 of 31 shared products, but 17 of 48 search results differed. Pass latitude/longitude to see the range of a specific area.
Does the on_offer filter work?
Yes: "fromage" returned 30 products with on_offer=true, all 30 carrying a promotion, against 1 promoted product in the first 48 unfiltered.
How many products per page?
Up to 48 (24 by default). next_cursor continues: three pages in a row returned 72 different products.
Are barcodes included?
No, Monoprix does not print them on product sheets.
How fresh is the data?
Every call reads the site live; nothing is cached.
What is the Monoprix API?
Monoprix API is a ReefAPI endpoint group for monoprix online groceries (courses.monoprix.fr) as json: eur shelf and unit prices, promotions, ingredients, allergens and nutrition. It returns live JSON through POST requests under /monoprix/v1.
Is the Monoprix API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. Monoprix calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Monoprix login or account?
No login to Monoprix is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the Monoprix data?
The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the Monoprix API use?
Monoprix actions currently cost 1-3 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call Monoprix from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call monoprix actions with the same key, credit pool and JSON envelope used by normal REST requests.
Is the Monoprix API a Monoprix scraper?
It is the managed alternative to a DIY Monoprix scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same monoprix online groceries (courses.monoprix.fr) as json: eur shelf and unit prices, promotions, ingredients, allergens and nutrition back as clean JSON.