bol.com
bol.com Category API
The products in one bol.com category by category id, paged, sorted by popularity, price, rating or most wished for, and filtered like search by price, condition, deals, delivery, brand or any facet: each product with its buy-box offer, rating and sponsored flag, plus the category with its breadcrumbs, bol's total and facets. Categories go deeper than search's 10 pages (a capture read 69). 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/jsoncategory_idstringrequiredA bol.com category id: category_path[].category_id of a product, the category facet of a search, or dominant_category. Category ids are the same on every storefront.
Example: 8440
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.
price_minnumberLowest price in euros.
Example: 50
price_maxnumberHighest price in euros. price_min must not exceed price_max.
Example: 250
conditionstring | string[]One or more of new, refurbished, second_hand: keeps products with an offer in that condition. offer stays the buy box (often new); cheapest_second_hand and cheapest_refurbished carry those offers.
Example: ["refurbished", "second_hand"]
deals_onlybooleanOnly products on a deal.
Example: true
select_dealsbooleanOnly bol Select member deals (the list, not Select member prices).
Example: true
deliverystring | string[]Delivery filters as bol offers them: today, tomorrow, evening, sunday, free_shipping (one or more).
Example: tomorrow
brand_facet_idstringA brand value id from the brand facet of an earlier answer (facets[].values[].id of the Merk / Marque facet, e.g. 4294862300 Apple). A different id space from brand_id of the brand endpoint (Apple is 5070005 there).
Example: 4294862300
facetsstring[]Up to 10 facet value ids from facets[].values[].id of an earlier answer (any facet: colour, size, rating band ...). Ids bol did not apply come back in filters_ignored.
Example: ["4294862300"]
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)
# Discounted products in a category, with the reference price each discount is measured against.
d = client.bolcom.category(category_id="8440", country="be", language="fr", deals_only=True)["data"]
print(d["category"]["name"], d["total"], "products")
for i in d["items"]:
o = i["offer"] or {}
print(i["product_id"], o.get("price"), o.get("reference_price"), o.get("reference_price_type"), o.get("discount_percent"))Response