coolblue.be APIcoolblue.be ↗
Access Coolblue Belgium product data via API. Search electronics, browse GPUs, CPUs, and smartphones, and retrieve live prices and stock availability.
curl -X GET 'https://api.parse.bot/scraper/30136e3d-48af-40d4-a418-dfcf5029f660/search_products?query=headphones' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products by keyword query on Coolblue.be. Returns a list of matching products with names, prices, availability, and product IDs. Handles search redirects to brand or category pages automatically.
| Param | Type | Description |
|---|---|---|
| queryrequired | string | Search keyword (e.g. 'iPhone', 'headphones', 'monitor') |
{
"type": "object",
"fields": {
"query": "search query string echoed back",
"total": "integer count of products returned",
"products": "array of product objects with product_id, name, url, price, currency, availability, image, rating, review_count"
},
"sample": {
"data": {
"query": "iPhone",
"total": 22,
"products": [
{
"url": "https://www.coolblue.be/nl/product/969443/apple-iphone-17-pro-256gb-blauw.html",
"name": "Apple iPhone 17 Pro 256GB Blauw",
"image": "https://image.coolblue.be/500x500/products/2213003",
"price": "1329",
"rating": "N/A",
"currency": "EUR",
"product_id": "969443",
"availability": "InStock",
"review_count": 0
}
]
},
"status": "success"
}
}About the coolblue.be API
The Coolblue.be API covers 7 endpoints for querying Belgium's largest electronics retailer, returning product names, prices in EUR, availability status, ratings, and review counts. Use search_products to find items by keyword, or hit category-specific endpoints like get_gpu_listings and get_cpu_listings to paginate through entire product categories with consistent response fields across all results.
What the API Returns
All listing endpoints — get_gpu_listings, get_cpu_listings, get_smartphone_listings, and the general get_category_listings — return paginated arrays of product objects. Each object includes product_id, name, url, price, currency (EUR), availability, image, rating, and review_count. The total_pages field lets you walk the full catalogue without guessing page boundaries. The get_category_listings endpoint accepts a category_path parameter such as 'laptops/windows-laptops' or 'videokaarten', making it more flexible than the named-category shortcuts.
Search and Product Detail
search_products takes a single query string (e.g. 'iPhone', 'monitor') and echoes back the query alongside a total count and the matching product array. It handles search redirects automatically, so a brand search like 'Samsung' that Coolblue internally routes to a brand page still resolves to a product list. For deeper inspection, get_product_details accepts a full product URL and returns the extended set of fields: brand, a description (HTML-encoded), an images array, and rating with review_count — richer than what listing endpoints expose.
Price and Availability Checks
get_product_price_and_availability is a lightweight endpoint for polling current price and stock status on a single item. It returns price, currency, availability (as a schema.org URL, e.g. https://schema.org/InStock), and product_id without the full spec payload. This makes it suitable for price-tracking pipelines where full product detail is already cached and only the mutable fields need refreshing.
- Track daily price changes on GPUs by polling
get_gpu_listingsand comparing storedpricevalues. - Build a CPU benchmark comparison tool by enriching
get_cpu_listingsresults withget_product_detailsspecs. - Monitor smartphone availability for drop-in-stock alerts using
get_product_price_and_availability. - Aggregate Belgian electronics pricing across categories via
get_category_listingswith customcategory_pathvalues. - Feed a shopping comparison site with Coolblue product names, images, and ratings from
search_products. - Identify top-rated products in a category by filtering on
ratingandreview_countfrom listing responses. - Automate competitive price intelligence for Belgium's electronics market using paginated category sweeps.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Coolblue have an official public developer API?+
What does `get_product_details` return that listing endpoints do not?+
get_product_details returns additional fields not present in listing arrays: brand, description (HTML-encoded product description), and images (an array of image URLs). Listing endpoints return a single image field and omit brand and description entirely.Does `get_category_listings` cover all Coolblue categories, or only a fixed set?+
category_path string, including nested paths like 'laptops/windows-laptops', so it is not limited to a fixed set. The named-category endpoints (get_gpu_listings, get_cpu_listings, get_smartphone_listings) are convenience shortcuts for three common categories.Does the API return product specifications or filter options (e.g. RAM size, GPU memory)?+
description field at the detail level, but no structured technical specifications or facet filter values. You can fork this API on Parse and revise it to add a specifications endpoint that parses the spec table from individual product pages.How does pagination work across category endpoints?+
page integer (current page), count (products on that page), and total_pages (estimated total pages). Pass the page parameter incrementally to retrieve subsequent pages. The total_pages value is an estimate, so treat it as a ceiling rather than an exact page count.