bol.com
bol.com Deals API
Today's bol.com deals as bol's deals page serves them on the Dutch, Belgian Dutch or Belgian French storefront: the day deal with its campaign id, end time and highlighted product, and the first deal products of a few categories, each with price, reference price and its type, discount and labels, plus the ids of the other deal categories. Open the day deal's products with campaign. 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/jsoncountryenum<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)
# Today's deals on bol.com Belgium, then every product of the day deal.
d = client.bolcom.deals(country="be")["data"]
dd = d["day_deal"]
print(dd["title"], "ends", dd["ends_at"])
for c in d["category_deals"]:
for p in c["products"]:
o = p["offer"] or {}
print(c["category_name"], p["product_id"], o.get("price"), o.get("reference_price"), o.get("discount_percent"))
day = client.bolcom.campaign(campaign_id=dd["campaign_id"], country="be")["data"]
print(day["total"], "products in the day deal")Response