bol.com
bol.com Offers API
The sellers' offers on one bol.com product, for price comparison and competitor price monitoring: the counts of new, refurbished and second-hand offers across all its offers, and the 10 lowest-priced offers, cheapest first as bol orders them (has_more when bol lists more), each with price, reference price, condition and refurbished grade, shipping cost, delivery promise, labels and the seller with its rating out of 10 and top-seller flag. By product id or link, 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/jsonproduct_idstringA bol.com product id as a string (items[].product_id of a search answer; 16 digits). Send product_id or url.
Example: 9300000240171936
urlstringA bol.com product link or the product's price overview link: its storefront is used unless country or language are sent.
Example: https://www.bol.com/nl/nl/p/apple-iphone-17-256gb-zwart/9300000240171936/
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)
# The lowest-priced offers on one product, on the Dutch and the Belgian storefront.
for country in ["nl", "be"]:
d = client.bolcom.offers(product_id="9300000240171936", country=country)["data"]
print(country, d["counts"])
for o in d["offers"]:
s = o["seller"]
print(" ", o["price"], o["condition"], o.get("refurbished_grade"), s["name"], s.get("rating"), o["delivery_date"])Response