bol.com
bol.com Seller Products API
The products a bol.com seller sells, by seller id or link, paged and sorted by popularity, price, rating or most wished for: each product with its title, brand, category, rating and buy-box offer (price, reference price, discount, condition, delivery promise), which can be another seller's offer, plus the seller, bol's total and facets. On the Dutch, Belgian Dutch or Belgian French storefront. Costs 2 credits.
Authorizations
AuthorizationstringheaderrequiredBearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).
Body
application/jsonseller_idstringA bol.com seller id (offer.seller_id of a list item or offers[].seller.seller_id). seller_id 0 is bol itself (400): use search or category for bol's own range. Send seller_id or url.
Example: 1767374
urlstringA bol.com seller link (seller.url of a seller answer), or the link of the seller's product list.
countryenum<string>default:nlThe 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:nlThe 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:1Results 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:popularityResult 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.
| storefront | Body | Market | Language |
|---|---|---|---|
nl-nl | country nl (the default) | bol.com Netherlands, EUR | Dutch |
be-nl | country be | bol.com Belgium, EUR | Dutch |
be-fr | country be, language fr | bol.com Belgium, EUR | French 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 competitor's catalogue on bol.com Belgium, and whether they hold the buy box on each product.
seller_id = "1767374"
d = client.bolcom.seller_products(seller_id=seller_id, country="be")["data"]
print(d["seller"]["name"], d["total"], "products,", d["max_page"], "pages")
for i in d["items"]:
o = i["offer"] or {}
print(i["product_id"], o.get("price"), "holds buy box" if o.get("seller_id") == seller_id else "buy box: " + str(o.get("seller_name")))Response