bol.com
bol.com Seller API
A bol.com seller's public profile by seller id or link: name, active since, description, the rating out of 10 with up to four sub-ratings (product information, delivery time, shipping, service), how bol computes it, the positive percentage, review counts by sentiment, top-seller status, product count, and the trader data bol publishes under EU rules (company name, city, country, registration and VAT number; no street address). Review texts are not returned. 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, offers[].seller.seller_id or buy_box.seller.seller_id). seller_id 0 is bol itself, which has no seller profile (400). Send seller_id or url.
Example: 1770745
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).
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)
# Who are the other sellers on my product? One offers call, then one seller call each.
offers = client.bolcom.offers(product_id="9300000240171936")["data"]["offers"]
for sid in {o["seller"]["seller_id"] for o in offers if not o["seller"]["sold_by_bol"]}:
s = client.bolcom.seller(seller_id=sid)["data"]["seller"]
b = s["business"] or {}
print(s["name"], s["rating"], s["positive_percent"], s["reviews"]["total"], b.get("company_name"), b.get("country"))Response