Search bol products

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

bol (bol.com, Netherlands and Belgium) product search with every filter the shop offers: product id, link, title, brand, rating and review count, the best offer (seller, price, list price, unit price, delivery promise and date, shipping cost, deals, loyalty points), the cheapest new and second-hand offers, category paths, highlights, sustainability verdict, sponsored flag, image and description. facets lists the categories, brands and every other filter for the query with their value ids (pass them in filters), plus the price range. The shop shows up to max_page pages (often 10). 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
qrequired string Search keywords. Example: koffie
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 (e.g. 4288800517 for the brand Douwe Egberts, 58334 for deals only).
category string Only this category (an id from the category facet, e.g. 20598).
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 (bol.com/nl, default) or be (bol.com/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/search?q=koffie" \
  -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)

{"query": "lego","country": "nl","applied_filters": {"sort": "relevance","page": 1},"corrected_query": null,"page": 1,"total": 11412,"max_page": 10,"count": 30,"next_page": 2,"category": null,"breadcrumb": [],"dominant_category": {"id": "20001","name": "Bouwsets"},"popular_filters": [{"id": "4288914533","name": "LEGO"},{"id": "4279522805","name": "Volwassenen"},"… 4 more"],"facets": [{"id": "category","name": "Categorie","type": "category","values": [{"id": "7934","name": "Speelgoed","count": 7437,"selected": false},{"id": "20001","name": "Bouwsets","count": 6150,"selected": false},"… 27 more"]},{"id": "4842","name": "Merk","type": "values","unit": null,"values": [{"id": "4288914533","name": "LEGO","count": 6262,"selected": false},{"id": "4295284523","name": "CADA","count": 21,"selected": false},"… 178 more"]},"… 20 more"],"products": [{"id": "9300000361134324","url": "https://www.bol.com/nl/nl/p/glazen-vitrinekast-met-led-verlichting-en-slot-4-planken-vitrinekast-van-gehard-glas-grote-display-kast-wandvitr…","title": "Glazen vitrinekast met LED-verlichting en slot – 4 planken vitrinekast van gehard glas – grote display kast / wandvitrine voor verzamelobjec…","subtitle": null,"brand": {"id": "609674240","name": "MEXUS","url": "https://www.bol.com/nl/nl/b/mexus/609674240/"},"rating": null,"review_count": 0,"sponsored": true,"sponsor": {"adAuctionId": "ca614389-aa7f-44ae-9ed8-961fab2d7a18","adId": "1000000012522633","adTransparency": {"beneficiary": {"…": "1 fields"},"payer": {"…": "1 fields"}}},"offer": {"offer_id": "96c58b53-1dec-4479-a3df-99114d983451","seller": {"id": "1853151","name": "Mavtei","rating": null,"url": "https://www.bol.com/nl/nl/v/x/1853151/"},"sold_by_bol": false,"price": 206,"currency": "EUR","list_price": null,"list_price_label": null,"strikethrough": null,"unit_price": null,"unit": null,"select_price": null,"bundle_prices": null,"condition": "new","offer_type": "STANDARD","delivery": "Uiterlijk 17 november in huis","delivery_by": "2026-11-17","release_date": null,"shipping_cost": null,"delivered_within_48h": false,"scarce": false,"deals": [],"loyalty_points": null},"cheapest_new": {"offer_id": "96c58b53-1dec-4479-a3df-99114d983451","seller": {"id": "1853151","name": "Mavtei","rating": null,"url": "https://www.bol.com/nl/nl/v/x/1853151/"},"sold_by_bol": false,"price": 206,"currency": "EUR","list_price": null,"list_price_label": null,"strikethrough": null,"unit_price": null,"unit": null,"select_price": null,"bundle_prices": null,"condition": "new","offer_type": "STANDARD","delivery": "Uiterlijk 17 november in huis","delivery_by": "2026-11-17","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/glazen-vitrinekast-met-led-verlichting-en-slot-4-planken-vitrinekast-van-gehard-glas-grote-display-…","categories": ["Wonen > Meubels > Kasten > Vitrinekasten","Wonen > Meubels > Kasten","… 2 more"],"highlights": [],"sustainability": null,"energy_label": null,"family_id": "9300000339592604","image": "https://media.s-bol.com/kE3mVyWnlBYJ/OMnyXXE/550x550.jpg","description": "Moderne glazen vitrinekast met stijlvol design Deze glazen vitrinekast combineert een modern, minimalistisch ontwerp met praktische opbergru…"},{"id": "9300000224667117","url": "https://www.bol.com/nl/nl/p/tidyup-opbergmand-met-speelmat-speelgoed-mand-voor-kinderkamer-opbergbox-met-deksel-grijs-xxl-geschikt-voor-lego…","title": "TidyUp Speelgoedmand met Speelmat – Opbergmand XXL met Deksel – Opbergbox voor Kinderkamer – Geschikt voor LEGO & Duplo – Grijs","subtitle": null,"brand": {"id": "607361506","name": "TidyUp","url": "https://www.bol.com/nl/nl/b/tidyup/607361506/"},"rating": 4.7,"review_count": 6,"sponsored": true,"sponsor": {"adAuctionId": "ca614389-aa7f-44ae-9ed8-961fab2d7a18","adId": "1000000013541244","adTransparency": {"beneficiary": {"…": "1 fields"},"payer": {"…": "1 fields"}}},"offer": {"offer_id": "aa4086f0-b4b5-4dfa-a168-556190c72492","seller": {"id": "1861531","name": "Veldstra Trading","rating": null,"url": "https://www.bol.com/nl/nl/v/x/1861531/"},"sold_by_bol": false,"price": 49.95,"currency": "EUR","list_price": null,"list_price_label": null,"strikethrough": null,"unit_price": null,"unit": null,"select_price": null,"bundle_prices": null,"condition": "new","offer_type": "STANDARD","delivery": "Uiterlijk 10 november in huis","delivery_by": "2026-11-10","release_date": null,"shipping_cost": null,"delivered_within_48h": false,"scarce": false,"deals": [],"loyalty_points": null},"cheapest_new": {"offer_id": "aa4086f0-b4b5-4dfa-a168-556190c72492","seller": {"id": "1861531","name": "Veldstra Trading","rating": null,"url": "https://www.bol.com/nl/nl/v/x/1861531/"},"sold_by_bol": false,"price": 49.95,"currency": "EUR","list_price": null,"list_price_label": null,"strikethrough": null,"unit_price": null,"unit": null,"select_price": null,"bundle_prices": null,"condition": "new","offer_type": "STANDARD","delivery": "Uiterlijk 10 november in huis","delivery_by": "2026-11-10","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/tidyup-opbergmand-met-speelmat-speelgoed-mand-voor-kinderkamer-opbergbox-met-deksel-grijs-xxl-gesch…","categories": ["Huishouden > Opbergers > Opbergmanden","Huishouden > Opbergers","… 1 more"],"highlights": ["1 stuk(s)","Kunststof","… 2 more"],"sustainability": null,"energy_label": null,"family_id": "9300000204153334","image": "https://media.s-bol.com/ZxnwBqr49vw2/pYj6ONr/550x557.jpg","description": "Opruimen in een paar seconden met TidyUp! Het opruimen van LEGO, Duplo en ander speelgoed is nog nooit zo eenvoudig geweest. Met de TidyUp O…"},"… 28 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.