+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
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} 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 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
| bol search suggestions /bol/ | $1 · $2 PAYG 1 credit |
| Search bol products /bol/ | $1 · $2 PAYG 1 credit |
| bol seller /bol/ | $1 · $2 PAYG 1 credit |
| bol seller products /bol/ | $1 · $2 PAYG 1 credit |
| bol product reviews /bol/ | $1 · $2 PAYG 1 credit |
| bol category products /bol/ | $1 · $2 PAYG 1 credit |
| bol product offers /bol/ | $1 · $2 PAYG 1 credit |
| bol product /bol/ | $1 · $2 PAYG 1 credit |
Call the bol API
Search bol products: GET https://api.api.sh/bol/
curl "https://api.api.sh/bol/v1/search?q=koffie" \
-H "x-api-key: $APISH_KEY" import os, requests
res = requests.get(
"https://api.api.sh/bol/v1/search",
params={"q": "koffie"},
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/search");
url.searchParams.set("q", "koffie");
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(); # Google Sheets (API.SH add-on)
=APISH("/bol/v1/search", "q", "koffie")
# Zapier, Make, n8n (verified node): pick the API.SH app,
# choose "bol" and "Search bol products".
# AI agents (Claude, ChatGPT, Cursor): add the
# API.SH MCP server https://api.sh/mcp - Create a free accountConfirm your email and get 1,000 free credits every month. No card needed.
- Create an API keyOne key works for all 913 platforms.
- Send the requestJSON back in one call. Add
output=csvoroutput=ndjsonfor 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.