+Coolblue API
Search Coolblue and pull products, prices, specifications, ratings and store stock as clean JSON.
The API.SH Coolblue API turns public Coolblue pages into structured JSON for the Dutch and Belgian shops. Search products or list a category with every filter its filter page offers (brand, specs, price range, review score), then pull a product's full record: price incl. and excl. VAT, availability, rating out of 10 with the distribution and per-aspect scores, pros and cons, the full specification table, what is in the box, second-chance offer, promotions and stock in each Coolblue store. A store list endpoint returns every Coolblue store with address and coordinates.
- 4 endpoints
- from $1 / 1,000 calls
- 1,000 free credits / month
- failed calls free
GET https://api.api.sh/coolblue/v1/ search
{"query": "bosch wasmachine","applied_filters": {"sort": "relevance","page": 1},"page": 1,"total_pages": 2,"next_page": 2,"count": 24,"products": [{"id": "957503","name": "Bosch WGE0340CNL","brand": "Bosch","brand_id": "1201","url": "https://www.coolblue.nl/product/957503/bosch-wge0340cnl.html","image": "https://image.coolblue.nl/500x500/products/1635495424","price": 529,"price_excl_vat": 437.19008,"list_price": null,"currency": "EUR","availability": "OnStock","expected_release": null,"rating": 8.9,"rating_scale": 10,"reviews_count": 71,"product_type": "wasmachines","product_type_id": "2675","highlights": [],"sponsored": false},{"id": "945891","name": "Bosch WGG244ZONL Iron Assist","brand": "Bosch","brand_id": "1201","url": "https://www.coolblue.nl/product/945891/bosch-wgg244zonl-iron-assist.html","image": "https://image.coolblue.nl/500x500/products/1043366405","price": 699,"price_excl_vat": 577.68595,"list_price": 959,"currency": "EUR","availability": "OnStock","expected_release": null,"rating": 9,"rating_scale": 10,"reviews_count": 332,"product_type": "wasmachines","product_type_id": "2675","highlights": [],"sponsored": false},"… 22 more"],"facets": [{"name": "producttype","label": "Categorie","type": "value","multiple": false,"unit": null,"min": null,"max": null,"values": [{"value": "cleaning","label": "schoonmaakmiddelen","count": 1,"selected": false,"filter": "producttype:cleaning"},{"value": "stapelkits","label": "stapelkits","count": 3,"selected": false,"filter": "producttype:stapelkits"},"… 2 more"]},{"name": "merk","label": "Merk","type": "value","multiple": true,"unit": null,"min": null,"max": null,"values": [{"value": "bluebuilt","label": "BlueBuilt","count": 3,"selected": false,"filter": "merk:bluebuilt"},{"value": "bosch","label": "Bosch","count": 31,"selected": false,"filter": "merk:bosch"},"… 1 more"]},"… 12 more"],"sorts": ["relevance","rating","… 3 more"],"cached": false,"credits_used": 1} What you can build with the Coolblue API
Price and promotion tracking
Follow prices, list prices, cashback labels and second-chance offers for products and categories you care about.
Category and assortment analysis
List a category with brand and spec filters and use the facet counts to see how the range is split by brand, energy class or size.
Product content and specs
Pull full specification tables, highlights, pros and cons and images to compare models or enrich your own catalog.
Store stock and local availability
See which Coolblue stores have a product in stock and where it is on display, with store addresses from the store list.
Coolblue data you get
Field names from real responses. Numbers come parsed, URLs absolute, dates in ISO 8601.
Coolblue API endpoints and prices
Coolblue endpoints cost 1 to 2 credits per call: credits are $1 per 1,000 on a monthly plan, $2 pay-as-you-go. Pricing
| Search Coolblue products /coolblue/ | $1 · $2 PAYG 1 credit |
| Coolblue category products /coolblue/ | $1 · $2 PAYG 1 credit |
| Coolblue product details /coolblue/ | $2 · $4 PAYG 2 credits |
| Coolblue stores /coolblue/ | $1 · $2 PAYG 1 credit |
Call the Coolblue API
Search Coolblue products: GET https://api.api.sh/coolblue/
curl "https://api.api.sh/coolblue/v1/search?q=bosch+wasmachine" \
-H "x-api-key: $APISH_KEY" import os, requests
res = requests.get(
"https://api.api.sh/coolblue/v1/search",
params={"q": "bosch wasmachine"},
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/coolblue/v1/search");
url.searchParams.set("q", "bosch wasmachine");
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("/coolblue/v1/search", "q", "bosch wasmachine")
# Zapier, Make, n8n (verified node): pick the API.SH app,
# choose "Coolblue" and "Search Coolblue 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 918 platforms.
- Send the requestJSON back in one call. Add
output=csvoroutput=ndjsonfor files.
Why API.SH for Coolblue data
- Public data only: no Coolblue login, cookies or account needed
- One key and one response shape for Coolblue and 917 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 Coolblue API
Coolblue's API is a business ordering API that connects a company's purchasing system to Coolblue Business; it is not an open product data API. API.SH returns Coolblue's public product, category and store data without a business account.
Rather than running your own Coolblue scraper or buying a single-purpose scraper on Apify or Piloterr, use one key and the same JSON format you get for every other API.SH shop.
Coolblue API questions
What Coolblue data can I get?+
Product search (/coolblue/v1/search), category listings with every filter and facet (/coolblue/v1/category), a product's full record with specs, ratings, pros and cons and store stock (/coolblue/v1/product) and the store list (/coolblue/v1/stores).
How much does the Coolblue API cost?+
Per call: /coolblue/v1/category, /coolblue/v1/search and /coolblue/v1/stores cost 1 credit; /coolblue/v1/product costs 2 credits. 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 /coolblue/v1/category at 1 credit each.
Is there an official Coolblue API?+
Coolblue offers an ordering API for Coolblue Business customers to connect their purchasing systems. It is not meant for reading product data. API.SH reads the public shop pages instead.
Do I need a Coolblue account or login?+
No. API.SH reads public Coolblue pages only. No endpoint uses a login, cookies or anyone's account.
Which countries are covered?+
The Dutch shop (coolblue.nl) and the Belgian shop in Dutch (coolblue.be/nl). Pass country=nl or country=be.
How do Coolblue filters work in the API?+
Every category response lists its facets with a ready filter value such as merk:bosch. Pass them in filter (several values with commas, several facets separated by |), plus min_price, max_price, min_rating and sort.
How do I get started?+
Sign up at api.sh, copy your API key and call /coolblue/v1/category with id=wasmachines or /coolblue/v1/search with a q parameter. See https://api.sh/docs, the SDKs, Google Sheets, Zapier, Make, n8n or the MCP server at https://api.sh/mcp.
Does the Coolblue API have a rate limit?+
No. API.SH puts no rate limit on your key: send as many Coolblue calls in parallel as you need and pay only for the calls that run. If Coolblue itself slows down, the call returns 503 with a retry-after header and is not charged.