ScavioScavio
Pricing
Tools
Sign InsGet Startedg
Blog
Bolcom12 min readNov 17, 2026

How to Get bol.com Seller Prices With an API: The Buy Box, bol's Own Offer and Partner Offers by Product ID or EAN, Netherlands and Belgium

Get bol.com seller prices with Scavio's bol.com API: read the buy box by product id or EAN, list seller offers, check ratings and Belgium, then poll daily.

Scavio Team

Nov 17, 2026

Try the bol.com API free
scavio
Marketplace / Competitor prices
Bolcom

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

Bash
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"}'
JSON
{
  "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

Bash
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"}'
JSON
{
  "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

Bash
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"}'
JSON
{
  "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

Python
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

Bash
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"}'
JSON
{
  "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

Bash
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"}'
JSON
{
  "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

Bash
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"}'
JSON
{
  "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:

Python
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

EndpointWhat it returnsStorefrontsCredits
searchProducts by keyword with the buy-box offer, rating, sponsored flag and facets, pages 1 to 10nl-nl, be-nl, be-fr2
productBuy box, offer count, cheapest and fastest new, refurbished grades, specs, rating, review topics, first 10 reviewsnl-nl, be-nl, be-fr2 (4 by EAN)
offersUp to the 10 lowest-priced offers with counts for all offers by condition, shipping cost and delivery datenl-nl, be-nl, be-fr2
sellerRating out of 10, sub-ratings, positive percentage, review counts, product count, EU trader datanl-nl, be-nl, be-fr2
seller-productsA seller's products with their buy-box offer, paged and sortednl-nl, be-nl, be-fr2
categoryProducts in a category, filtered and sorted like search, deeper pagesnl-nl, be-nl, be-fr2
brandProducts of one brand by brand_idnl-nl, be-nl, be-fr2
dealsToday's day deal and category dealsnl-nl, be-nl, be-fr2
campaignThe products of one promotion, such as a Black Friday deal listnl-nl, be-nl, be-fr2

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

  1. Create a free Scavio account: 50 credits, no card, enough to read 12 products fully.
  2. Read one product and its offers in the playground.
  3. Turn your EAN list into product ids once (step 2), then keep the ids.
  4. 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.

Read every bol.com seller's price with two calls

  • The buy box with its reference price and type
  • Seller offers with shipping cost and delivery date
  • bol.com Netherlands, Belgium in Dutch and in French
Try the bol.com API free

50 free credits, no credit card

On this page

  1. Step 1: Search bol.com for the product
  2. Step 2: Read the buy box, by product id or EAN
  3. Step 3: List the seller offers
  4. Step 4: Compare the buy box, the cheapest offer and bol's own price

Related articles

View all
  • scavio
    Marketplace / Competitor prices
    Bolcom
    7 Best bol.com Competitor Price APIs in 2026: Scavio Read 48 bol.com Products, and bol Kept the Buy Box on All 35 It Sold Itself
  • scavio
    Marketplace / Competitor prices
    Bolcom
    Why Are Some bol.com Prices So High? We Read 48 Products: Partner Sellers Priced Above bol's Own Offer on 60 of 61 Offers, a Median 19% per Product
ScavioScavio

One scraper API for every social, search, e-commerce and real estate platform. Built for AI agents.

Product

  • Features
  • Pricing
  • Dashboard
  • Affiliates

Developers

  • Documentation
  • API Reference
  • Quickstart
  • MCP Integration
  • Python SDK

Alternatives

  • Tavily Alternative
  • SerpAPI Alternative
  • Firecrawl Alternative
  • Exa Alternative
  • Serper Alternative
  • Tavily vs Scavio
  • SerpAPI vs Scavio
  • All alternatives
  • Compare Scavio vs alternatives

Search APIs

  • Google Search API
  • Amazon Product API
  • YouTube API
  • Reddit API
  • Walmart Product API
  • TikTok API
  • Instagram API

Tools

  • All Tools

Ask AI about Scavio

© 2026 Scavio. All rights reserved.

Featured on TAAFT
Terms of ServicePrivacy Policy