bol+API.SH

bol API

Search bol.com and pull products, prices, every seller's offer and reviews as clean JSON.

The API.SH bol API returns public bol.com data for the Netherlands and Belgium as structured JSON. Search or browse categories with the shop's own filters (brand and other facet values, price range, minimum rating, sorts), get search suggestions, open a product for its specifications, images, best offer and review summary, list every seller's offer per condition, page through reviews, and look up a marketplace seller's profile and products.

  • 8 endpoints
  • from $1 / 1,000 calls
  • 1,000 free credits / month
  • failed calls free
Search bol products
GET https://api.api.sh/bol/v1/search
{"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}
1 credit · $1 per 1,000 calls

What you can build with the bol API

Price and Buy Box monitoring

Track a product's best offer and every seller's price, delivery promise and shipping cost to see who wins the sale and when prices move.

Competitor seller research

Look up a marketplace seller's rating, review totals and company details, then page through the products they sell.

Category and assortment analysis

Browse a category with brand, price and rating filters to see which products and brands lead it.

Review mining

Pull reviews with pros, cons and ratings, filtered by stars or topic, to learn what Dutch and Belgian buyers praise or complain about.

Keyword research

Collect bol.com search suggestions for a term to find the queries and categories shoppers use.

bol data you get

Field names from real responses. Numbers come parsed, URLs absolute, dates in ISO 8601.

bol search suggestions/bol/v1/autocomplete
querykoff
categories[]id · name · department · url
products[]id · title · url · image
bol category products/bol/v1/category
id20598countrynltitleKoffiepage1total4648max_page194count29next_page2
applied_filters[]sort · page
category[]id · name
breadcrumb[]id · name · url
popular_filters[]id · name
bol product offers/bol/v1/offers
product_id9300000000788662conditionnewcount1
offers[]offer_id · seller · sold_by_bol · price · currency · list_price · list_price_label · strikethrough · unit_price · unit · select_price · bundle_prices

bol API endpoints and prices

Every bol endpoint costs 1 credit per call: credits are $1 per 1,000 on a monthly plan, $2 pay-as-you-go. Pricing

Search and discovery2
bol search suggestions
/bol/v1/autocomplete
params qdocstry
$1 · $2 PAYG
1 credit
Search bol products
/bol/v1/search
params q +9 optionaldocstry
$1 · $2 PAYG
1 credit
Profiles and accounts2
bol seller
/bol/v1/seller
params iddocstry
$1 · $2 PAYG
1 credit
bol seller products
/bol/v1/seller-products
params id +5 optionaldocstry
$1 · $2 PAYG
1 credit
Comments and reviews1
bol product reviews
/bol/v1/reviews
params id +5 optionaldocstry
$1 · $2 PAYG
1 credit
Products, listings and places3
bol category products
/bol/v1/category
params id +8 optionaldocstry
$1 · $2 PAYG
1 credit
bol product offers
/bol/v1/offers
params id +1 optionaldocstry
$1 · $2 PAYG
1 credit
bol product
/bol/v1/product
params id +1 optionaldocstry
$1 · $2 PAYG
1 credit

Call the bol API

Search bol products: GET https://api.api.sh/bol/v1/search

curl "https://api.api.sh/bol/v1/search?q=koffie" \
  -H "x-api-key: $APISH_KEY"
  1. Create a free accountConfirm your email and get 1,000 free credits every month. No card needed.
  2. Create an API keyOne key works for all 913 platforms.
  3. Send the requestJSON back in one call. Add output=csv or output=ndjson for files.

Why API.SH for bol data

  • Public data only: no bol login, cookies or account needed
  • One key and one response shape for bol and 912 other platforms
  • Built and maintained by API.SH, not third-party publishers
  • Pay per call; errors on our side cost nothing
  • No rate limits: run as many calls in parallel as you need
  • Live status for every endpoint

API.SH vs the official bol API

bol has an official Retailer API for sellers to manage their own offers, orders and shipments, and a Marketing API for affiliate partners; both need a bol partner account and credentials. API.SH needs no bol account and returns public catalog data any visitor sees: search results, all sellers' offers, reviews and seller profiles.

Instead of building a bol.com scraper or relying on a RapidAPI listing, use one API.SH key with the same JSON shape across marketplaces such as bol, Amazon and Kaufland.

bol API questions

What bol data can I get?+

Product search (/bol/v1/search), category listings (/bol/v1/category), search suggestions (/bol/v1/autocomplete), one product with specifications and offers (/bol/v1/product), reviews (/bol/v1/reviews), every seller's offer (/bol/v1/offers), seller profiles (/bol/v1/seller) and a seller's products (/bol/v1/seller-products).

How much does the bol API cost?+

Every bol endpoint costs 1 credit per call. On a monthly plan 1,000 credits cost $1 (Starter is $50/month for 50,000 credits). Pay-as-you-go is $2 per 1,000 credits, with top-ups from $15 that never expire.

Is there a free trial?+

Yes. Every account gets 1,000 free credits every month. That is 1,000 calls to /bol/v1/autocomplete at 1 credit each.

Is there an official bol API?+

Yes, for partners. The bol Retailer API lets sellers manage their own offers and orders, and the Marketing API serves affiliates; both need credentials from a bol partner account. API.SH covers public catalog data for anyone, including competitors' offers.

Do I need a bol account or login?+

No. API.SH reads public bol.com pages only. You do not need a bol seller, partner or customer account.

How do I get started?+

Sign up at api.sh, copy your API key and call /bol/v1/search?q=koffie. The docs at https://api.sh/docs show every parameter with a live example; there are SDKs, plus Google Sheets, Zapier, Make, n8n and an MCP server at https://api.sh/mcp.

How is this different from the bol Retailer API?+

The Retailer API manages your own listings and orders as a seller. API.SH reads the public shop: any product, every seller's offer, reviews and seller ratings, without a seller account.

Does it cover bol.com Belgium?+

Yes. Search, category and product take country=be for bol.com Belgium; the default is the Netherlands.

Is scraping bol.com legal?+

API.SH returns public product and review data that anyone can see on bol.com without an account. Use it for research, price tracking and analysis, and follow bol's terms and the law where you operate, especially when you republish data.

Does the bol API have a rate limit?+

No. API.SH puts no rate limit on your key: send as many bol calls in parallel as you need and pay only for the calls that run. If bol itself slows down, the call returns 503 with a retry-after header and is not charged.

More e-commerce APIs all e-commerce APIs →

Start with 1,000 free credits
Every month, on every account. One key works for all 913 platforms.
Get a free API key