Boulanger API & Scraper
Boulanger is one of France's largest electronics and home-appliance retailers, with its own stock and a marketplace of third-party sellers.
🤖 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.
This API reads boulanger.com as JSON. `search` takes French keywords or a category and narrows by brand, seller (Boulanger or a marketplace seller), price range, new or refurbished, minimum star rating and presence in one store; it sorts by relevance, price or rating and returns 40 products per page with price, struck-through price and its type, discount, the éco-participation and private-copy levy included in the price, seller, condition, availability, rating, review count and energy class, plus the brands, sellers and stores you can filter on. `product` returns the full record with every offer of every seller, EAN, specs, promotions including manufacturer rebates (ODR), legal warranty and the instalment plan. `delivery` lists home delivery, store pickup and parcel-point options with dates and prices for a French postal code, `store_stock` the stores still holding units with their quantity, and `reviews` the customer reviews, paged and sortable.
What a Boulanger field actually contains
Fields that read differently from how they look. Every row was measured against live boulanger.com pages on 2026-10-14.
| Field | What it holds |
|---|---|
| product_id | The number in boulanger.com/ref/<product_id>: 7 digits for products Boulanger sells (1243116), 10 digits for marketplace-only products (9001023316). The same value goes unchanged into product, delivery, store_stock and reviews; a product URL works too. |
| price | Euros including VAT, as the page prints it. It matched the printed price and the page's structured data on 10 of 10 products checked, and the search card on 14 of 14. |
| strikeout_price, strikeout_label | The struck-through price and the words printed next to it: "Prix de référence" (shown with a -NN % badge) or "Ancien prix" (no badge). They are different kinds of reference and are never merged; null when the page shows no struck price. |
| eco_participation, private_copy_levy | The "dont 3,07€ d'éco-part." and "dont 16,80€ de copie privée" amounts printed under the price. They are already INCLUDED in price, not extra. Matched the printed amounts on 10 of 10 products. Private-copy levy exists only on storage devices (phones, tablets), so it is null on TVs and appliances. |
| offers[] | Every offer for the product: Boulanger's own (is_boulanger true) and each marketplace seller's, in the site's order, each with its own price, struck price, levies and availability. One TV had 4 sellers from 649.00 to 734.99 €; a smartphone had 12 offers. |
| promotions[].is_odr, odr_amount | is_odr is true when the promotion links a manufacturer-rebate form (offre de remboursement) or says "remboursés"; odr_amount is the euro amount printed in its label ("100€ remboursés à l'achat d'un Pixel 11" → 100). The price after the rebate is not computed: the rebate is claimed from the brand after purchase. |
| delivery options | Computed by Boulanger for the postal_code you send (default 75001, Paris): mode, carrier, earliest date window, price and price before discount. Stores and pickup points change with the postal code: Paris and Marseille returned different stores for the same product. |
| store_stock.stores[] | The stores Boulanger lists as still holding units of the offer, nearest to your postal code first, with quantity and distance in km. Marketplace offers are never in stores and return an empty list. |
Prices are in euros including French VAT. The same postal code read from two different networks in the same minute returned identical delivery options, dates and prices on 3 of 3 products.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/boulanger/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"query": "television",
"brand": "Samsung"
}
}{
"ok": true,
"meta": {
"api": "boulanger",
"endpoint": "search",
"mode": "live",
"latency_ms": 1434,
"record_count": 40,
"bytes": 1487711,
"cache_hit": false,
"total": 182,
"price_basis": "EUR, VAT included, as boulanger.com prints it; éco-participation and private-copy levy are INCLUDED in the price (published separately as the amount 'dont …')",
"pagination": {
"page": 1,
"last_page": 5,
"has_more": true
},
"upstream_requests": 1,
"charged_credits": 3,
"version": "0.1.0",
"request_id": "78891e47bbf6412a",
"queue_ms": 1.4,
"fetched_at": "2026-10-14T18:57:18.796Z"
},
"data": {
"query": {
"query": "television",
"brand": "Samsung",
"sort": "relevance",
"page": 1
},
"total": 182,
"page": 1,
"last_page": 5,
"has_more": true,
"results": [
{
"product_id": "1240038",
"offer_id": "e39f8adc-fca2-4e0f-a5bf-062bd3c2a7f1",
"url": "https://www.boulanger.com/ref/1240038",
"title": "TV LED SAMSUNG TU55U8005H (2026) 55\" (138 cm) 4K Ultra HD - Smart TV avec IA",
"brand": "SAMSUNG",
"image": "https://boulanger.scene7.com/is/image/Boulanger/8806097954903_h_f_l_0",
"price": 479,
"price_excl_vat": 399.17,
"currency": "EUR",
"strikeout_price": 529,
"strikeout_label": "Ancien prix",
"discount_pct_printed": null,
"discount_pct": 9,
"eco_participation": 17.47,
"private_copy_levy": null,
"seller": "boulanger",
"seller_type": "boulanger",
"is_marketplace": false,
"condition": "neuf",
"available": true,
"rating": 3.1,
"rating_exact": 3.1110999584198,
"review_count": 9,
"energy_class": "F",
"key_points": [
"Fréquence de balayage native : 50 Hz, Fréquence optimisée : Non concerné",
"Système d'exploitation : TV connectée Tizen",
"HDMI 2.1 : x3, USB : x1"
],
"flaps": [],
"promotions": [
"Pensez à la location",
"Jusqu'à 65€ cagnottés nouveaux adhérents"
],
"category_codes": [
"tv_-_image_-_son",
"televiseur"
],
"price_witness": 479
},
{
"product_id": "1240090",
"offer_id": "0860d3ac-8a2d-4f8c-905a-1a992e2e7cfc",
"url": "https://www.boulanger.com/ref/1240090",
"title": "TV Mini LED SAMSUNG TU65M80H (2026) 65\" (163 cm) 4K 144 Hz - Smart TV avec IA",
"brand": "SAMSUNG",
"image": "https://boulanger.scene7.com/is/image/Boulanger/8806099009427_h_f_l_0",
"price": 779,
"price_excl_vat": 649.17,
"currency": "EUR",
"strikeout_price": null,
"strikeout_label": null,
"discount_pct_printed": null,
"discount_pct": null,
"eco_participation": 17.47,
"private_copy_levy": null,
"seller": "boulanger",
"seller_type": "boulanger",
"is_marketplace": false,
"condition": "neuf",
"available": true,
"rating": 4.7,
"rating_exact": 4.699999809265137,
"review_count": 10,
"energy_class": "D",
"key_points": [
"Fréquence de balayage native : 100 Hz, Fréquence optimisée : jusqu'à 144 Hz",
"Système d'exploitation : TV connectée Tizen",
"HDMI 2.1 : x3, USB : x2"
],
"flaps": [
"50€ remboursés*"
],
"promotions": [
"Louer dès 20,99€/mois",
"50€ remboursés*"
],
"category_codes": [
"tv_-_image_-_son",
"televiseur"
],
"price_witness": 779
},
{
"product_id": "1239971",
"offer_id": "df75eaef-d3e1-4ddb-84f3-bd0cc9d94e99",
"url": "https://www.boulanger.com/ref/1239971",
"title": "TV LED SAMSUNG TU43U8005H (2026) 43\" (108 cm) 4K Ultra HD - Smart TV avec IA",
"brand": "SAMSUNG",
"image": "https://boulanger.scene7.com/is/image/Boulanger/8806097954880_h_f_l_0",
"price": 369,
"price_excl_vat": 307.5,
"currency": "EUR",
"strikeout_price": 399,
"strikeout_label": "Ancien prix",
"discount_pct_printed": null,
"discount_pct": 7,
"eco_participation": 13.42,
"private_copy_levy": null,
"seller": "boulanger",
"seller_type": "boulanger",
"is_marketplace": false,
"condition": "neuf",
"available": true,
"rating": 3.1,
"rating_exact": 3.1110999584198,
"review_count": 9,
"energy_class": "F",
"key_points": [
"Fréquence de balayage native : 50 Hz, Fréquence optimisée : Non concerné",
"Système d'exploitation : TV connectée Tizen",
"HDMI 2.1 : x3, USB : x1"
],
"flaps": [],
"promotions": [
"Jusqu'à 65€ cagnottés nouveaux adhérents",
"1er mois Canal+ offert sans engagement"
],
"category_codes": [
"tv_-_image_-_son",
"televiseur"
],
"price_witness": 369
}
],
"facets": {
"brands": [
{
"value": "samsung",
"label": "TV LED",
"count": 23
},
{
"value": "schneider",
"label": "SCHNEIDER",
"count": 1
},
{
"value": "sharp",
"label": "SHARP",
"count": 9
}
],
"sellers": [
{
"value": "boulanger",
"label": "Boulanger",
"count": 116
},
{
"value": "boulanger202nd20life",
"label": "Boulanger 2nd life",
"count": 2
},
{
"value": "easylounge",
"label": "EasyLounge",
"count": 1
}
]
}
}
}What the Boulanger API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | Search boulanger.com by keyword, or list a category, optionally narrowed by brand, seller (Boulanger or a marketplace seller), price range, condition (new / refurbished), minimum star rating and presence in one store, in one of the site's four sort orders. 40 products per page with price, struck-through price and its type, discount, éco-participation and private-copy levy included in the price, seller and seller type, condition, availability, rating, review count, energy class, key points and promotions; plus the source's own facet values (brands, sellers, stores, conditions) with counts. Needs `query` OR `category`. | Pricing teams call search to search boulanger.com by keyword, or list a category, optionally narrowed by brand, seller (Bo…. | query, category, brand, seller, min_price, ... |
| product | One boulanger.com product, complete: title, brand, EAN, manufacturer reference, release date, rating and review count, category path, key points, description, pictograms, images, energy label, full spec sheet, promotions with their dates, and EVERY offer — Boulanger's own and each marketplace seller's — with price (VAT included), struck-through price and its type (Prix de référence / Ancien prix), discount %, éco-participation and private-copy levy included in the price, other price components, availability, sale channels (web / store), legal warranty, trade-in eligibility, instalment plan and the supplier's legal identity. | Marketplace operators call product to get one boulanger.com product, complete. | product_id, url |
| delivery | Delivery and pickup options of one offer for a French postal code, as the product page computes them: home delivery (standard / express / with installation), store pickup (Retrait en magasin, with the store), Drive, parcel pickup points (Colissimo, Mondial Relay, Chronopost) — each with carrier, earliest date window, price, price before discount and Club prices — plus the nearest stores and pickup points with distance, and what cannot be delivered there. | Catalog enrichment teams call delivery to get delivery and pickup options of one offer for a French postal code, as the product page comput…. | product_id, url, offer_id, postal_code |
| store_stock | The Boulanger stores the site lists as still holding units of an offer (its 'derniers articles en magasin' list), nearest to a postal code first: store, site code, quantity, address and distance. | Retail analysts call store_stock to get the Boulanger stores the site lists as still holding units of an offer (its 'derniers article…. | product_id, url, offer_id, postal_code |
| reviews | Customer reviews of one product: star rating, title, full text, reviewer's public nickname, post time, experience date, helpful votes, photos and seller responses, with the source's review total and average. Up to 50 per call, paged with `page`. | Pricing teams call reviews to get customer reviews of one product. | product_id, url, sort, page, limit |
Call search from your stack
curl -X POST https://api.reefapi.com/boulanger/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"television","brand":"Samsung"}'import requests
r = requests.post(
"https://api.reefapi.com/boulanger/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "television",
"brand": "Samsung"
},
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/boulanger/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"query": "television",
"brand": "Samsung"
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.boulanger.search with {"query":"television","brand":"Samsung"}.Who uses this API and why
- Monitor Boulanger prices, struck-through prices and discounts for a list of products every day.
- Compare Boulanger's own offer with each marketplace seller's price on the same product.
- Track manufacturer rebates (ODR) and promotions with their start and end dates.
- Check same-day store pickup and delivery dates for a product across French postal codes.
- Collect French customer reviews and ratings for electronics and appliances.
Questions developers ask before integrating
Do I need a Boulanger account?
No. Everything is read logged out, and you call reefapi.com from anywhere.
Which search filters are there, and do they really filter?
Brand, seller, price range, condition (new or refurbished), minimum rating, store presence, three sort orders and paging. Each was checked against the unfiltered count in the same run: "television" 669 → Samsung 182, seller EasyLounge 12, seller Boulanger 380, 200 to 400 € 115 (every row in range), refurbished 89, 4 stars and up 257, 5 stars 66, one store 17.
What happens with a brand or seller that does not exist?
You get an empty result with total 0, never the unfiltered list. The search answer also returns the brands, sellers and stores the source offers for that search, with their counts, so you can pass a value that exists.
Can I tell Boulanger's own offers from marketplace sellers?
Yes. Every search row has seller and is_marketplace, and product lists each seller's offer separately with is_boulanger. Filtering seller=Boulanger returned only Boulanger's own offers (380 of 669 TVs).
Is the éco-participation added on top of the price?
No. Boulanger prints it as "dont X€" (of which X €): it is part of the displayed price. The API returns the amount separately so you can subtract it if you need the price without it.
Does delivery depend on where I call from?
No, on the postal_code you pass. 75001 returned Paris stores and four options, 13001 returned Marseille stores and three options, for the same television.
How many reviews can I read?
All of them, 1 to 50 per call with page; a television with 244 reviews returned pages of 20 with no overlap. Sorts: newest, best or worst rating, most helpful, with photos first.
How deep does search go?
40 products per page until the source's total; a page past the last one returns an empty list with a note. "ordinateur portable" listed 2,217 products, the smartphone category 2,009.
What is the Boulanger API?
Boulanger API is a ReefAPI endpoint group for france's electronics and appliance retailer: prices with éco-participation, every marketplace offer, delivery and store pickup by postal code, store stock and reviews. It returns live JSON through POST requests under /boulanger/v1.
Is the Boulanger API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. Boulanger calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Boulanger login or account?
No login to Boulanger 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 Boulanger 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 Boulanger API use?
Boulanger actions currently cost 2-3 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call Boulanger from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call boulanger actions with the same key, credit pool and JSON envelope used by normal REST requests.