To get bol.com seller prices, call Scavio's bol.com API twice per product: POST /api/v1/bolcom/product with a product_id, a link or an ean returns the buy box (the offer bol shows first, with price, seller, reference price and its type, shipping cost and delivery date) and the cheapest new offer, and POST /api/v1/bolcom/offers returns the offers from bol and partner sellers, lowest price first, up to 10 per call, with counts for all offers by condition. Each call costs 2 credits, 4 for an EAN lookup, on bol.com Netherlands and Belgium.
bol lists the offers for one product in a price overview: bol's own offer when bol sells it, and offers from some of its 42,612 sales partners (bol, September 30, 2026). One of them is the buy box. bol has no history view of these prices, so the work is: find the product, read the buy box, list the offers, check the sellers, compare the two countries, and store what you read each day. Every response below is a trimmed capture from Scavio's bol.com API on November 17, 2026, between 13:40 and 13:59 UTC. Prices are numbers in euros. Long fields, images and most of each list are cut.
Step 1: Search bol.com for the product
curl -s https://api.scavio.dev/api/v1/bolcom/search \
-H "Authorization: Bearer $SCAVIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "iphone 17"}'{
"query": "iphone 17",
"total": 17324,
"page": 1,
"max_page": 10,
"has_more": true,
"sort": "relevance",
"count": 29,
"sponsored_count": 6,
"country": "nl",
"language": "nl",
"storefront": "nl-nl",
"currency": "EUR",
"items": [
{
"product_id": "9300000441501686",
"title": "Apple iPhone 17 - 256GB - White",
"brand": { "brand_id": "5070005", "name": "Apple" },
"rating": { "average": 4.4, "count": 9 },
"offer": {
"price": 935,
"reference_price": null,
"reference_price_type": null,
"discount_percent": null,
"discount_shown": false,
"condition": "new",
"seller_id": "1705484",
"sold_by_bol": false,
"delivery_date": "2026-11-18"
},
"cheapest_refurbished": {
"price": 755,
"condition": "refurbished",
"refurbished_grade": "B",
"seller_id": "1849943",
"sold_by_bol": false,
"delivery_date": "2026-11-24"
},
"sponsored": false
}
]
}Each item carries its buy-box offer, so a search already shows who holds the buy box and at what price. product_id is a 16-digit string: keep it as a string, a JSON number that long loses digits. Search goes to page 10 (about 280 results) and sorts by relevance, popularity, price_asc, price_desc, rating or wishlist; filters cover price range, condition, deals, delivery and brand. sponsored marks paid placements: 6 of 29 here. List items carry no EAN; the product answer has it. It answered in 3.0 seconds. 2 credits.
Step 2: Read the buy box, by product id or EAN
curl -s https://api.scavio.dev/api/v1/bolcom/product \
-H "Authorization: Bearer $SCAVIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"product_id": "9300000441501686"}'{
"product_id": "9300000441501686",
"ean": "0195950643640",
"title": "Apple iPhone 17 - 256GB - White",
"brand": { "brand_id": "5070005", "name": "Apple" },
"buy_box": {
"offer_id": "ccd15937-a373-440c-b422-0a47275d3886",
"price": 935,
"reference_price": null,
"reference_price_type": null,
"discount_percent": null,
"discount_shown": false,
"condition": "new",
"seller": { "seller_id": "1705484", "name": "Smartech NL", "sold_by_bol": false },
"shipping_cost": 0,
"delivery_text": "Op voorraad. Voor 23:59 uur besteld, morgen in huis",
"delivery_date": "2026-11-18",
"delivered_within_48h": true,
"low_stock": false,
"labels": []
},
"offer_count": 11,
"cheapest_new": { "price": 933.95 },
"fastest_new": {
"price": 949,
"delivery_text": "Op voorraad. Voor 23:59 uur besteld, morgen in huis",
"delivery_date": "2026-11-18"
},
"cheapest_second_hand": null,
"refurbished": [
{ "grade": "A", "grade_name": "Zo goed als nieuw", "offer_count": 2 },
{ "grade": "B", "grade_name": "Licht gebruikt", "offer_count": 1 }
],
"rating": {
"average": 4.4,
"count": 9,
"distribution": { "1": 0, "2": 1, "3": 1, "4": 0, "5": 7 }
},
"country": "nl",
"storefront": "nl-nl",
"currency": "EUR"
}This is one of the two products, of 48 we read that day, where the buy box was not the cheapest new offer: a partner held it at €935 with delivery promised for November 18, while cheapest_new was €933.95. offer_count counts offers in every condition (8 new and 3 refurbished here). reference_price is the price bol shows next to the buy box; reference_price_type is rrp (the supplier's recommended price, bol's "Adviesprijs") or most_shown_price (bol's most-shown non-promotional price over the last 90 days). discount_percent is computed against it unless bol strikes the price through (discount_shown true); bol struck through none of the 48 buy boxes we read. refurbished gives each grade's cheapest offer in full (cut here). The product answer also has specifications, bol's AI review topics and the first 10 reviews. It answered in 1.4 seconds. 2 credits.
With an EAN instead, send {"ean": "0195950643640"}. The answer is the same product with requested_ean added and credits_used 4: it is a search plus the product page. It answered in 3.4 seconds. Store the product_id and use it from then on.
Step 3: List the seller offers
curl -s https://api.scavio.dev/api/v1/bolcom/offers \
-H "Authorization: Bearer $SCAVIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"product_id": "9300000441501686"}'{
"product_id": "9300000441501686",
"title": "Apple iPhone 17 - 256GB - White",
"counts": { "new": 8, "refurbished": 3, "second_hand": 0 },
"count": 10,
"has_more": true,
"offers": [
{
"offer_id": "4c0885f6-dd93-407e-9cb2-523758ec5f6c",
"price": 755,
"condition": "refurbished",
"refurbished_grade": "B",
"seller": { "seller_id": "1849943", "name": "Alloccaz", "sold_by_bol": false },
"shipping_cost": 0,
"delivery_text": "Uiterlijk 24 november in huis",
"delivery_date": "2026-11-24"
},
{
"offer_id": "a54223a6-3f61-4af6-9a0a-c9129ef66738",
"price": 933.95,
"condition": "new",
"seller": { "seller_id": "1434961", "name": "EPD Mobile BV", "sold_by_bol": false },
"shipping_cost": 0,
"delivery_date": "2026-11-20"
},
{
"offer_id": "ccd15937-a373-440c-b422-0a47275d3886",
"price": 935,
"condition": "new",
"seller": { "seller_id": "1705484", "name": "Smartech NL", "sold_by_bol": false },
"shipping_cost": 0,
"delivery_date": "2026-11-18"
}
],
"storefront": "nl-nl",
"currency": "EUR"
}Offers come lowest price first across conditions, so filter on condition before you take a cheapest new price. The call returns up to the 10 lowest-priced offers: counts adds to 11 here, and has_more is true because the eleventh, the most expensive, is not in the list. On the 48 products we read, 5 had more than 10 offers. The list does not mark the buy box; match offer_id to the product's buy_box.offer_id, as the third offer above does. shipping_cost and delivery_date are per offer, and seller.sold_by_bol is true for bol's own offer (seller id 0). It answered in 1.3 seconds. 2 credits.
Step 4: Compare the buy box, the cheapest offer and bol's own price
import requests
API = "https://api.scavio.dev/api/v1/bolcom"
HEADERS = {"Authorization": "Bearer YOUR_SCAVIO_API_KEY"}
def read(product_id, country="nl"): # 4 credits: product + offers
body = {"product_id": product_id, "country": country}
p = requests.post(f"{API}/product", headers=HEADERS, json=body, timeout=120).json()["data"]
o = requests.post(f"{API}/offers", headers=HEADERS, json=body, timeout=120).json()["data"]
new = [x for x in o["offers"] if x["condition"] == "new"]
bb = p["buy_box"]
cheapest = min(new, key=lambda x: x["price"] + (x.get("shipping_cost") or 0))
bol = next((x for x in new if x["seller"]["sold_by_bol"]), None)
partners = [x["price"] for x in new if not x["seller"]["sold_by_bol"]]
print(p["title"])
print(f" buy box {bb['price']} by {'bol' if bb['seller']['sold_by_bol'] else 'a partner'}, "
f"cheapest new {cheapest['price']} + {cheapest.get('shipping_cost') or 0} shipping, "
f"offers listed {len(o['offers'])} of {sum(o['counts'].values())}")
if bol and partners:
premiums = sorted(round((x / bol["price"] - 1) * 100, 1) for x in partners)
print(f" bol {bol['price']}, partner premiums {premiums} %")
for pid in ["9300000441501686", "9300000239314960", "9200000005228466"]:
read(pid)On November 17, this read the iPhone 17 256GB White (buy box €935 by a partner, cheapest new €933.95), AirPods Pro 3 (buy box €208.95 by bol, partners +1.5% and +11.5%) and Hugo Boss Femme 75 ml (bol €26.62, nine partners from +20.3% to +68.2%, with 10 of 11 offers listed). Across the 19 of our 48 products where bol and a partner both sold new, 60 of 61 partner offers were priced above bol's own, by a median of +18.8% per product; why are some bol.com prices so high? has the full chart. On all 35 products bol sold, bol held the buy box. 4 credits a product.
Step 5: Check a seller
curl -s https://api.scavio.dev/api/v1/bolcom/seller \
-H "Authorization: Bearer $SCAVIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"seller_id": "1849943"}'{
"seller": {
"seller_id": "1849943",
"name": "Alloccaz",
"active_since": "2026-03-04T10:33:08.331484",
"rating": 8.6,
"rating_details": { "product_info": 9.6, "delivery_time": 9, "shipping": 9.8 },
"rating_method": "recent_reviews",
"reviews_used_for_rating": 5,
"positive_percent": 100,
"top_seller": false,
"reviews": { "positive": 4, "neutral": 1, "negative": 0, "total": 5 },
"product_count": 186,
"business": { "company_name": "RECOMMERCE SOLUTIONS", "city": "GENTILLY", "country": "FR" }
},
"storefront": "nl-nl"
}The seller answer gives bol's rating out of 10 with up to four sub-ratings (product information, delivery time, shipping, service; this seller has three), rating_method (which reviews count), the positive percentage, review counts by sentiment, product count and the EU trader data bol publishes (company, city, country, and registration and VAT number, cut here). No street address and no review texts. Across the 5 partner sellers we read, ratings ran from 7.6 to 9.4 out of 10 (median 8.6) and review totals from 5 to 569. Ratings change: bol moves partner reviews to a new format in December 2026, so date what you store. It answered in 1.5 seconds. 2 credits.
Step 6: Read the same product in Belgium
curl -s https://api.scavio.dev/api/v1/bolcom/product \
-H "Authorization: Bearer $SCAVIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"product_id": "9300000441501686", "country": "be"}'{
"product_id": "9300000441501686",
"buy_box": {
"offer_id": "48f7bced-1dfc-4596-bb37-355944c111d0",
"price": 935,
"condition": "new",
"seller": { "seller_id": "1663947", "name": "The Store", "sold_by_bol": false },
"shipping_cost": 0,
"delivery_text": "Op voorraad. Voor 17:00 uur besteld, morgen in huis",
"delivery_date": "2026-11-18"
},
"offer_count": 9,
"cheapest_new": { "price": 933.95 },
"country": "be",
"language": "nl",
"storefront": "be-nl",
"currency": "EUR"
}Product ids, EANs and seller ids are the same on every storefront, so the same id works with "country": "be". Prices, offers and the buy box can differ: here Belgium had 9 offers against 11, and the buy box went to another partner at the same €935. On the 15 products we read in both countries, the buy-box price differed on 1 (AirPods Pro 3, €208.95 and €209.00) and the 15 had 65 offers in Belgium against 86 in the Netherlands. One seller appeared with a different seller id in each country, so match sellers per storefront. Add "language": "fr" for bol.com Belgium in French: bol's own texts come in French, review texts are bol's translation, and bol's AI review topics stay in Dutch. 2 credits.
Step 7: Read deals and Black Friday campaigns
curl -s https://api.scavio.dev/api/v1/bolcom/campaign \
-H "Authorization: Bearer $SCAVIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"campaign_id": "542047"}'{
"campaign": {
"campaign_id": "542047",
"name": "Deal op luxe verzorging",
"description": null,
"type": "discount",
"ends_at": "2026-12-01T00:00:00.000+01:00"
},
"total": 1341,
"page": 1,
"max_page": 56,
"sort": "popularity",
"items": [
{
"product_id": "9300000120263026",
"title": "La Roche-Posay Cicaplast B5+ Balsem - Voor een gevoelige huid - Tribioma, Vitamine B5 en Madecassoside - 100ml",
"offer": {
"price": 16.99,
"reference_price": 18.38,
"reference_price_type": "rrp",
"discount_percent": 8,
"discount_shown": false,
"sold_by_bol": false,
"labels": [
{ "text": "Black Friday deal", "campaign_id": "542047", "mechanism": "price_off" }
]
}
}
]
}A campaign id comes from an offer's labels (as above) or from deals, which returns today's day deal and category deals. On November 17 two campaigns carried the "Black Friday deal" label, both ending December 1. On page 1 of this beauty campaign, 20 of 24 discounts were against the recommended price (median 40%) and 4 against bol's most-shown price; on a smartwatch-accessories campaign of 14,828 products all 24 were against the most-shown price (median 15%), 9 of them struck through. The type tells you what a discount is measured against; we make no claim about whether a discount is real. Campaign pages default to popularity order, 24 items a page. It answered in 3.4 seconds. 2 credits.
Step 8: Poll daily through Black Friday and keep the rows
Nothing in a response gives yesterday's prices, so the series is what you store. This reads the buy box and offers once a day and appends every offer:
import csv, datetime, requests
API = "https://api.scavio.dev/api/v1/bolcom"
HEADERS = {"Authorization": "Bearer YOUR_SCAVIO_API_KEY"}
PRODUCTS = ["9300000441501686", "9300000239314960", "9200000005228466", "9300000166374057"]
STOREFRONTS = [{"country": "nl"}, {"country": "be"}]
FIELDS = ["captured_at", "storefront", "product_id", "offer_id", "is_buy_box", "seller_id", "sold_by_bol",
"condition", "price", "shipping_cost", "delivery_date", "reference_price", "reference_price_type",
"offers_total"]
today = datetime.date.today().isoformat()
with open("bolcom_offers.csv", "a", newline="") as f:
w = csv.DictWriter(f, fieldnames=FIELDS)
for pid in PRODUCTS:
for sf in STOREFRONTS: # 4 credits per product per storefront
body = {"product_id": pid, **sf}
p = requests.post(f"{API}/product", headers=HEADERS, json=body, timeout=120).json()["data"]
o = requests.post(f"{API}/offers", headers=HEADERS, json=body, timeout=120).json()["data"]
bb_id = (p["buy_box"] or {}).get("offer_id")
for x in o["offers"]:
w.writerow({"captured_at": today, "storefront": o["storefront"], "product_id": pid,
"offer_id": x["offer_id"], "is_buy_box": x["offer_id"] == bb_id,
"seller_id": x["seller"]["seller_id"], "sold_by_bol": x["seller"]["sold_by_bol"],
"condition": x["condition"], "price": x["price"],
"shipping_cost": x.get("shipping_cost"), "delivery_date": x["delivery_date"],
"reference_price": x["reference_price"], "reference_price_type": x["reference_price_type"],
"offers_total": sum(o["counts"].values())})Each product costs 4 credits a day per storefront. 100 products on bol.com Netherlands are 400 credits a day; from November 26 to November 30, around Black Friday on November 27, that is 2,000 credits, $2 at the Growth rate of $1 per 1,000 credits, and twice that with Belgium. The Hobby plan, $15 a month for 3,000 credits, covers the Netherlands series. The buy box moves when bol's factors change (bol lists country, condition, fulfilment method, ultimate order time and price before and after discount), so is_buy_box per day is the signal to watch.
All 9 bol.com endpoints
| Endpoint | What it returns | Storefronts | Credits |
|---|---|---|---|
| search | Products by keyword with the buy-box offer, rating, sponsored flag and facets, pages 1 to 10 | nl-nl, be-nl, be-fr | 2 |
| product | Buy box, offer count, cheapest and fastest new, refurbished grades, specs, rating, review topics, first 10 reviews | nl-nl, be-nl, be-fr | 2 (4 by EAN) |
| offers | Up to the 10 lowest-priced offers with counts for all offers by condition, shipping cost and delivery date | nl-nl, be-nl, be-fr | 2 |
| seller | Rating out of 10, sub-ratings, positive percentage, review counts, product count, EU trader data | nl-nl, be-nl, be-fr | 2 |
| seller-products | A seller's products with their buy-box offer, paged and sorted | nl-nl, be-nl, be-fr | 2 |
| category | Products in a category, filtered and sorted like search, deeper pages | nl-nl, be-nl, be-fr | 2 |
| brand | Products of one brand by brand_id | nl-nl, be-nl, be-fr | 2 |
| deals | Today's day deal and category deals | nl-nl, be-nl, be-fr | 2 |
| campaign | The products of one promotion, such as a Black Friday deal list | nl-nl, be-nl, be-fr | 2 |
A not-found is charged; an upstream failure is not. Not available: price history, a 30-day lowest price, review paging beyond the first 10, search suggestions, pickup points and bol Select member prices.
Getting started
- Create a free Scavio account: 50 credits, no card, enough to read 12 products fully.
- Read one product and its offers in the playground.
- Turn your EAN list into product ids once (step 2), then keep the ids.
- Schedule step 8 from November 26 and keep the CSV; for agents, the same endpoints are tools in the Scavio MCP server.
Reference: bol.com API overview · product docs · offers docs · seller docs · the best bol.com competitor price APIs · why are some bol.com prices so high? · how to get Allegro price data · how to get Trendyol seller prices
Frequently asked questions
How do I see all sellers of a product on bol.com?
On bol.com, the price overview of a product lists the offers from bol and partner sellers. With Scavio's bol.com API, POST /api/v1/bolcom/offers with the product_id returns them lowest price first, up to 10 per call, with counts for all offers by condition and has_more when bol lists more. Each offer carries price, condition, shipping cost, delivery date and the seller, with sold_by_bol true for bol itself. 2 credits.
Can I look up a bol.com product by EAN?
Yes. POST /api/v1/bolcom/product with an ean (8, 12, 13 or 14 digits) finds the product carrying it and returns the same answer as a lookup by product_id, including the buy box and requested_ean. It costs 4 credits, a search plus the product page; keep the product_id it returns and use that afterwards for 2 credits, on every storefront.
Does bol.com charge shipping under 20 euros?
On bol's own offers, it did on the products we read: on November 17, 2026, bol charged 2.99 euros shipping on all 6 of its own offers priced under 20 euros (9.99 to 19.99) and nothing on the 29 above. Partner sellers set their own: 108 of 109 partner new offers we read had no shipping cost. The offers answer returns shipping_cost per offer, so compare price plus shipping.
Can I get competitor offers from bol's own API?
Yes, if you are a registered bol seller. bol's Retailer API has a competing-offers endpoint that returns every active offer on an EAN with the best-offer flag, at no fee, for your own sales. Affiliates get the best offer per product through the Marketing Catalog API. Without a seller or affiliate account, a third-party API such as Scavio's returns the buy box and seller offers.
Is the bol.com data in Dutch?
It comes in the storefront's language. bol.com Netherlands and the Dutch Belgian storefront return Dutch titles, descriptions and delivery texts. With country be and language fr, bol's own texts come in French, some partner titles stay Dutch, review texts are bol's translation, and bol's AI review topics come back in Dutch. Prices are in euros on all three.