bol.com
bol.com Product API
One bol.com product by product id, link or EAN, on the Dutch, Belgian Dutch or Belgian French storefront: EAN, title, brand, description, specifications, category path, the buy box (the offer bol shows first: price, reference price and its type, discount, seller with rating out of 10, condition, shipping cost, delivery promise, stock and labels), the offer count, the cheapest new, fastest new, cheapest second-hand and refurbished grades, energy label, images, rating with its 1-5 distribution, bol's AI review topics and the first 10 reviews. Costs 2 credits, 4 by EAN.
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, too long for a JSON number). Send exactly one of product_id, url or ean.
Example: 9300000239314960
urlstringA bol.com product link (https://www.bol.com/nl/nl/p/<slug>/<product id>/): its storefront is used unless country or language are sent.
Example: https://www.bol.com/nl/nl/p/apple-airpods-pro-3-in-ear-koptelefoon-usb-c/9300000239314960/
eanstringAn EAN / GTIN (8, 12, 13 or 14 digits): finds the product carrying it. 4 credits (a search plus the product page); the answer echoes requested_ean.
Example: 4242005483976
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)
# Your EAN on bol.com: who holds the buy box, at what price, against which reference price.
d = client.bolcom.product(ean="4242005483976", country="be", language="fr")["data"]
bb = d["buy_box"]
print(d["product_id"], d["title"], d["offer_count"], "offers")
print(bb["price"], bb["reference_price"], bb["reference_price_type"], bb["discount_percent"], bb["seller"]["name"])
print("cheapest new", d["cheapest_new"], "second hand", d["cheapest_second_hand"], "refurbished", d["refurbished"])Response