Coolblue+API.SH

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
Search Coolblue products
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}
1 credit · $1 per 1,000 calls

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.

Rating benchmarks

Compare ratings, review counts and per-aspect scores across competing products in a category.

Coolblue data you get

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

Coolblue category products/coolblue/v1/category
categorywasmachinespage1total_pages7next_page2count22
applied_filters[]filters · sort · page
products[]id · name · brand · brand_id · url · image · price · price_excl_vat · list_price · currency · availability · expected_release
facets[]name · label · type · multiple · unit · min · max · values
Coolblue product details/coolblue/v1/product
id935113nameAEG LR76CUCA06 ProSteam Universa…short_nameLR76CUCA06brandAEGbrand_id1358urlhttps://www.coolblue.nl/product/…product_typewasmachineproduct_type_id2675category_slugwasmachinesprice859price_excl_vat709.91736currencyEURavailabilityOnStockrating9.4rating_scale10reviews_count57descriptionFris je was snel op met de AEG L…manual_urlhttps://manuals.coolblue.nl/7e/a…
rating_by_aspect[]aspect · rating
rating_distribution[]stars · count
descriptions[]variation · text
specs[]group · properties
Search Coolblue products/coolblue/v1/search
querybosch wasmachinepage1total_pages2next_page2count24
applied_filters[]sort · page
products[]id · name · brand · brand_id · url · image · price · price_excl_vat · list_price · currency · availability · expected_release
facets[]name · label · type · multiple · unit · min · max · values

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 and discovery1
Search Coolblue products
/coolblue/v1/search
params q +3 optionaldocstry
$1 · $2 PAYG
1 credit
Products, listings and places2
Coolblue category products
/coolblue/v1/category
params id +7 optionaldocstry
$1 · $2 PAYG
1 credit
Coolblue product details
/coolblue/v1/product
params id +1 optionaldocstry
$2 · $4 PAYG
2 credits
More data1
Coolblue stores
/coolblue/v1/stores
params none required +1 optionaldocstry
$1 · $2 PAYG
1 credit

Call the Coolblue API

Search Coolblue products: GET https://api.api.sh/coolblue/v1/search

curl "https://api.api.sh/coolblue/v1/search?q=bosch+wasmachine" \
  -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 918 platforms.
  3. Send the requestJSON back in one call. Add output=csv or output=ndjson for 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.

More e-commerce APIs all e-commerce APIs →

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