ScavioScavio
Pricing
Tools
Sign InsGet Startedg
Quick StartAPI & SDKsEcosystem

bol.com

bol.com Brand API

Every product of one brand on bol.com, by brand id or brand link, paged and sorted by popularity, price, rating or most wished for: each product with its title, category, rating and buy-box offer (price, reference price and its type, discount, seller, delivery promise, labels), plus the brand, bol's total and facets. For brand price and reseller monitoring across the Dutch and Belgian storefronts. Costs 2 credits.

POST/api/v1/bolcom/brand

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).

Body

application/json
brand_idstring

A bol.com brand id: brand.brand_id of a search, list or product answer (Apple is 5070005). Not the brand_facet_id search takes: that is a different id space (Apple is 4294862300 there). Send brand_id or url.

Example: 5070005

urlstring

A bol.com brand link (https://www.bol.com/nl/nl/b/<slug>/<brand id>/): its storefront is used unless country or language are sent.

countryenum<string>default:nl

The bol.com storefront country: nl (bol.com Netherlands) or be (bol.com Belgium). Prices are euros on both. Anything else answers 400, not charged.

Example: be

  • nl — bol.com Netherlands (storefront nl-nl). The default.
  • be — bol.com Belgium: be-nl in Dutch, or be-fr with language fr.
languageenum<string>default:nl

The storefront language: nl (Dutch) or fr (French, only with country be: storefront be-fr). country nl with language fr answers 400, not charged.

Example: fr

  • nl — Dutch. The default, on nl and be.
  • fr — French, on be only (be-fr).
pageintegerdefault:1

Results page, 1-based, about 24 items a page, 1 to 500. max_page in the answer is bol's last page (bol lists at most 500 pages); a page above 500 answers 400, a page past max_page answers an empty page with a note.

Example: 2

sortenum<string>default:popularity

Result order. Listing pages default to popularity, as bol does; relevance is not offered here (400).

Example: price_asc

  • popularity — bol's popularity order. The default.
  • price_asc — Price, low to high, in bol's own ordering (small inversions against the live buy-box price occur).
  • price_desc — Price, high to low, in bol's own ordering.
  • rating — bol's rating order (a weighted order, not a strict sort by average).
  • wishlist — Most wished for first.

Notes

Storefronts. This endpoint serves nl-nl, be-nl, be-fr: country nl (default) or be, language nl (default) or fr, where fr is only on be. Every answer echoes country, language, storefront and currency (EUR). country nl with language fr answers 400, as does any other country or language, before anything is charged.

storefrontBodyMarketLanguage
nl-nlcountry nl (the default)bol.com Netherlands, EURDutch
be-nlcountry bebol.com Belgium, EURDutch
be-frcountry be, language frbol.com Belgium, EURFrench for bol's own texts; some partner titles and review_topics stay Dutch; review texts are bol's translation (is_translated)

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key", timeout=60)

# A brand's range on bol.com: who holds the buy box on each product, and at what discount.
d = client.bolcom.brand(brand_id="5070005", country="nl")["data"]
print(d["brand"]["name"], d["total"], "products,", d["max_page"], "pages")
for i in d["items"]:
    o = i["offer"] or {}
    print(i["product_id"], o.get("price"), o.get("reference_price_type"), o.get("discount_percent"), o.get("seller_name"))

Response

"count": 24,
"sponsored_count": 0,
"total": 2035,
"page": 1,
"max_page": 85,
"has_more": true,
"sort": "popularity",
"country": "nl",
"language": "nl",
"storefront": "nl-nl",
"currency": "EUR"
},
"response_time": 2400
}
Previousbol.com CategoryNextbol.com Deals
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