bol seller products
The products a bol seller offers, with the same fields, filters and facets as search. Pass next_page back as page; null on the last page.
Every response includes credits_used: the credits this call cost.
Part of the bol API: 8 endpoints with prices, use cases and example responses.
Parameters
| name | type | description |
|---|---|---|
idrequired | string | The seller id or a bol.com seller link. Example: 1645465 |
sort | relevance | popularity | price_asc | price_desc | rating | newest | wishlist | Order: relevance (default), popularity, price_asc, price_desc, rating, newest, wishlist. |
filters | string | Facet value ids from facets, comma-separated. |
min_price | number | Minimum price in euros. |
max_price | number | Maximum price in euros. |
page | integer | Page number, 1 for the first. Pass back next_page. |
Every endpoint also takes fresh, raw, fields (see lean responses and caching).
Example
curl "https://api.api.sh/bol/v1/seller-products?id=1645465" \
-H "x-api-key: $APISH_KEY" import os, requests
res = requests.get(
"https://api.api.sh/bol/v1/seller-products",
params={"id": "1645465"},
headers={"x-api-key": os.environ["APISH_KEY"]},
timeout=120,
)
res.raise_for_status()
data = res.json() const url = new URL("https://api.api.sh/bol/v1/seller-products");
url.searchParams.set("id", "1645465");
const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json(); Response
A JSON object with the fields described above, plus raw (the source's own data), cached, fetched_at and credits_used. Errors return {"success": false, "error": "…"} with the HTTP status (see errors). A lookup that ran but found nothing (404) costs the price above; refused calls and errors on our side are free (what's charged).
Example response (real call, trimmed: lists cut to 2 items, long text shortened, raw left out)
{"seller_id": "1645465","applied_filters": {"sort": "relevance","page": 1},"page": 1,"total": 275,"max_page": 12,"count": 24,"next_page": 2,"category": null,"breadcrumb": [],"dominant_category": null,"popular_filters": [],"facets": [{"id": "12194","name": "Prijs (€)","type": "range","unit": "€","min": 5.99,"max": 899.99,"applied_min": null,"applied_max": null,"values": []},{"id": "77683","name": "Duurzaamheidskenmerken","type": "values","unit": null,"values": [{"id": "7697906656","name": "B Corporation","count": 5,"selected": false},{"id": "7697906654","name": "Controle op herkomst","count": 1,"selected": false},"… 2 more"]}],"products": [{"id": "9200000058753825","url": "https://www.bol.com/nl/nl/p/hg-schimmelreiniger-schuimspray-500ml-de-nr-1-schimmelverwijderaar-vernietigt-de-hardnekkigste-schimmel-optimale…","title": "HG schimmelreiniger schuimspray 500ml","subtitle": null,"brand": {"id": "7584935","name": "HG","url": "https://www.bol.com/nl/nl/b/hg/7584935/"},"rating": 4.4,"review_count": 95,"sponsored": false,"offer": {"offer_id": "03cff93e-d06e-4b15-8a7f-350b99d3da95","seller": {"id": "1462170","name": "Sneltoner.nl","rating": null,"url": "https://www.bol.com/nl/nl/v/x/1462170/"},"sold_by_bol": false,"price": 12.49,"currency": "EUR","list_price": null,"list_price_label": null,"strikethrough": null,"unit_price": null,"unit": null,"select_price": null,"bundle_prices": [{"…": "3 fields"},{"…": "3 fields"}],"condition": "new","offer_type": "STANDARD","delivery": "Op voorraad. Voor 23:00 uur besteld, morgen in huis","delivery_by": "2026-11-05","release_date": null,"shipping_cost": null,"delivered_within_48h": true,"scarce": false,"deals": [],"loyalty_points": null},"cheapest_new": {"offer_id": "3c130853-2ca6-469c-a1c5-2935e813a3f0","seller": {"id": "1822319","name": "Voordeeldrogist.nl","rating": null,"url": "https://www.bol.com/nl/nl/v/x/1822319/"},"sold_by_bol": false,"price": 12,"currency": "EUR","list_price": null,"list_price_label": null,"strikethrough": null,"unit_price": null,"unit": null,"select_price": null,"bundle_prices": [{"…": "3 fields"}],"condition": "new","offer_type": "STANDARD","delivery": "Uiterlijk 11 november in huis","delivery_by": "2026-11-11","release_date": null,"shipping_cost": null,"delivered_within_48h": false,"scarce": false,"deals": [],"loyalty_points": null},"cheapest_secondhand": null,"offers_url": "https://www.bol.com/nl/nl/prijsoverzicht/hg-schimmelreiniger-schuimspray-500ml-de-nr-1-schimmelverwijderaar-vernietigt-de-hardnekkigste-schi…","categories": ["Huishouden > Schoonmaken > Schoonmaakmiddelen > Badkamer- & Wc reinigers > Badkamerreinigers","Huishouden > Schoonmaken > Schoonmaakmiddelen > Badkamer- & Wc reinigers","… 3 more"],"highlights": ["Inhoud: 500 ml","Aantal stuks: 1 stuk(s)"],"sustainability": null,"energy_label": null,"family_id": "9200000058753824","image": "https://media.s-bol.com/6ElAv3ywy9vO/nrQGmn7/226x840.jpg","description": "HG schimmelreiniger schuimspray vernietigt direct en eenvoudig alle schimmels. Deze zelfwerkende schuimspray met langere hechting rekent sne…"},{"id": "9200000128133976","url": "https://www.bol.com/nl/nl/p/laminaat-reiniger-n-72-hg/9200000128133976/","title": "HG laminaatreiniger (product 72) 1L","subtitle": null,"brand": {"id": "7584935","name": "HG","url": "https://www.bol.com/nl/nl/b/hg/7584935/"},"rating": 4.8,"review_count": 26,"sponsored": false,"offer": {"offer_id": "95f15863-0f74-4d7e-a0f5-6b10c931e532","seller": {"id": "0","name": "bol","rating": null,"url": null},"sold_by_bol": true,"price": 9.59,"currency": "EUR","list_price": null,"list_price_label": null,"strikethrough": null,"unit_price": null,"unit": null,"select_price": null,"bundle_prices": [{"…": "3 fields"},{"…": "3 fields"},"… 1 more"],"condition": "new","offer_type": "STANDARD","delivery": "Op voorraad. Voor 23:59 uur besteld, morgen in huis","delivery_by": "2026-11-05","release_date": null,"shipping_cost": null,"delivered_within_48h": true,"scarce": false,"deals": [],"loyalty_points": null},"cheapest_new": {"offer_id": "95f15863-0f74-4d7e-a0f5-6b10c931e532","seller": {"id": "0","name": "bol","rating": null,"url": null},"sold_by_bol": true,"price": 9.59,"currency": "EUR","list_price": null,"list_price_label": null,"strikethrough": null,"unit_price": null,"unit": null,"select_price": null,"bundle_prices": [{"…": "3 fields"},{"…": "3 fields"},"… 1 more"],"condition": "new","offer_type": "STANDARD","delivery": "Op voorraad. Voor 23:59 uur besteld, morgen in huis","delivery_by": "2026-11-05","release_date": null,"shipping_cost": null,"delivered_within_48h": true,"scarce": false,"deals": [],"loyalty_points": null},"cheapest_secondhand": null,"offers_url": "https://www.bol.com/nl/nl/prijsoverzicht/laminaat-reiniger-n-72-hg/9200000128133976/?filter=new&sort=price&sortOrder=asc","categories": ["Huishouden > Schoonmaken > Schoonmaakmiddelen > Vloerreinigingsmiddel","Huishouden > Schoonmaken > Water- & Stoomreinigers > Bijpassende reinigingsmiddelen","… 4 more"],"highlights": [],"sustainability": null,"energy_label": null,"family_id": "9200000128133975","image": "https://media.s-bol.com/ggYZqKKP3pok/rR27xAL/378x840.jpg","description": "HG laminaatreiniger is een heerlijk fris ruikende en geconcentreerde dweilreiniger voor alle soorten laminaatvloeren voor het regelmatig goe…"},"… 22 more"],"cached": false,"credits_used": 1}