bol category products

GET https://api.api.sh/bol/v1/category
1 credit / call e-commerce try it in the playground →

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

nametypedescription
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"

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}
The fastest way to see the full response is the playground: it runs this endpoint with your account and shows the exact JSON.