bol category products
The products of one bol category with the same fields, filters and facets as search, plus the category's breadcrumb and title. 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 | A category id (e.g. 20598 for Koffie) or a bol.com/nl/nl/l/<name>/<id>/ link. Example: 20598 |
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. |
min_rating | number | Minimum average rating, 1-5. |
include_unavailable | boolean | true to include products that are not available right now. |
country | nl | be | nl (default) or be. |
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/category?id=20598" \
-H "x-api-key: $APISH_KEY" import os, requests
res = requests.get(
"https://api.api.sh/bol/v1/category",
params={"id": "20598"},
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/category");
url.searchParams.set("id", "20598");
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)
{"id": "20598","country": "nl","applied_filters": {"sort": "relevance","page": 1},"title": "Koffie","description": null,"page": 1,"total": 4648,"max_page": 194,"count": 29,"next_page": 2,"category": {"id": "20598","name": "Koffie"},"breadcrumb": [{"id": "36080","name": "Eten & Drinken","url": "https://www.bol.com/nl/nl/l/eten-drinken/36080/"},{"id": "63487","name": "Frisdrank, sap, koffie en thee","url": "https://www.bol.com/nl/nl/l/frisdrank-sap-koffie-en-thee/63487/"},"… 1 more"],"dominant_category": null,"popular_filters": [{"id": "4288800517","name": "Douwe Egberts"},{"id": "58334","name": "Aanbiedingen"},"… 4 more"],"facets": [{"id": "category","name": "Categorie","type": "category","values": [{"id": "30274","name": "Koffiebonen","count": 1590,"selected": false},{"id": "30271","name": "Koffiecups","count": 962,"selected": false},"… 5 more"]},{"id": "4842","name": "Merk","type": "values","unit": null,"values": [{"id": "4288800517","name": "Douwe Egberts","count": 145,"selected": false},{"id": "4267573230","name": "Starbucks","count": 53,"selected": false},"… 550 more"]},"… 17 more"],"products": [{"id": "9300000368484836","url": "https://www.bol.com/nl/nl/p/nespresso-original-favorieten-pakket-120-capsules-voor-de-prijs-van-100/9300000368484836/","title": "Nespresso - Original - Favorieten Pakket - 120 capsules","subtitle": null,"brand": {"id": "14853146","name": "Nespresso","url": "https://www.bol.com/nl/nl/pb/nespresso/14853146/"},"rating": 4.6,"review_count": 21,"sponsored": true,"sponsor": {"adAuctionId": "ee40159f-d2e2-48a7-a274-5f2085191014","adId": "1000000012589090","adTransparency": {"beneficiary": {"…": "1 fields"},"payer": {"…": "1 fields"}}},"offer": {"offer_id": "6b3ce540-5e98-475c-b0b6-82a2ab63646a","seller": {"id": "1833421","name": "Nespresso Nederland","rating": null,"url": "https://www.bol.com/nl/nl/v/x/1833421/"},"sold_by_bol": false,"price": 57.2,"currency": "EUR","list_price": null,"list_price_label": null,"strikethrough": null,"unit_price": 0.48,"unit": "PK","select_price": null,"bundle_prices": null,"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": "6b3ce540-5e98-475c-b0b6-82a2ab63646a","seller": {"id": "1833421","name": "Nespresso Nederland","rating": null,"url": "https://www.bol.com/nl/nl/v/x/1833421/"},"sold_by_bol": false,"price": 57.2,"currency": "EUR","list_price": null,"list_price_label": null,"strikethrough": null,"unit_price": 0.48,"unit": "PK","select_price": null,"bundle_prices": null,"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_secondhand": null,"offers_url": "https://www.bol.com/nl/nl/prijsoverzicht/nespresso-original-favorieten-pakket-120-capsules-voor-de-prijs-van-100/9300000368484836/?filter=ne…","categories": ["Eten & Drinken > Frisdrank, sap, koffie en thee > Koffie > Koffiecups > Nespresso compatible cups","Eten & Drinken > Frisdrank, sap, koffie en thee > Koffie > Koffiecups","… 3 more"],"highlights": ["Compatibel met Nespresso","Cups","… 2 more"],"sustainability": "MORE_SUSTAINABLE","energy_label": null,"family_id": "9300000251323631","image": "https://media.s-bol.com/qNyoZkkoJXEk/ZYjqo2v/550x412.jpg","description": "Nespresso Original Koffiepromo Favorieten Pakket - 120 capsules Ontdek onze collectie. Een exclusieve verzameling van 11 koffies afkomstig u…"},{"id": "9300000383511412","url": "https://www.bol.com/nl/nl/p/nespresso-original-lungo-pakket-60-capsules/9300000383511412/","title": "Nespresso - Original - Lungo Pakket - 60 capsules","subtitle": null,"brand": {"id": "14853146","name": "Nespresso","url": "https://www.bol.com/nl/nl/pb/nespresso/14853146/"},"rating": 5,"review_count": 6,"sponsored": true,"sponsor": {"adAuctionId": "ee40159f-d2e2-48a7-a274-5f2085191014","adId": "1000000013441287","adTransparency": {"beneficiary": {"…": "1 fields"},"payer": {"…": "1 fields"}}},"offer": {"offer_id": "2b781bf4-6670-4822-806b-c863d84d8e45","seller": {"id": "1833421","name": "Nespresso Nederland","rating": null,"url": "https://www.bol.com/nl/nl/v/x/1833421/"},"sold_by_bol": false,"price": 33.3,"currency": "EUR","list_price": null,"list_price_label": null,"strikethrough": null,"unit_price": 0.56,"unit": "PK","select_price": null,"bundle_prices": null,"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": "2b781bf4-6670-4822-806b-c863d84d8e45","seller": {"id": "1833421","name": "Nespresso Nederland","rating": null,"url": "https://www.bol.com/nl/nl/v/x/1833421/"},"sold_by_bol": false,"price": 33.3,"currency": "EUR","list_price": null,"list_price_label": null,"strikethrough": null,"unit_price": 0.56,"unit": "PK","select_price": null,"bundle_prices": null,"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_secondhand": null,"offers_url": "https://www.bol.com/nl/nl/prijsoverzicht/nespresso-original-lungo-pakket-60-capsules/9300000383511412/?filter=new&sort=price&sortOrder=asc","categories": ["Eten & Drinken > Frisdrank, sap, koffie en thee > Koffie > Koffiecups > Nespresso compatible cups","Eten & Drinken > Frisdrank, sap, koffie en thee > Koffie > Koffiecups","… 3 more"],"highlights": ["Compatibel met Nespresso","Cups","… 2 more"],"sustainability": "MORE_SUSTAINABLE","energy_label": null,"family_id": "9300000216611461","image": "https://media.s-bol.com/zMpkNLlMj8lY/3QBAyR9/550x337.jpg","description": "Nespresso Original Koffiecups Lungo Pack - 60x capsules Ontdek onze collectie. Een exclusieve verzameling van 6 koffies afkomstig uit unieke…"},"… 27 more"],"cached": false,"credits_used": 1}