coolblue.nl APIcoolblue.nl ↗
Access Coolblue.nl product listings, laptop specs, customer reviews, and second-chance items via 8 structured endpoints. Search, filter by brand, and paginate results.
curl -X GET 'https://api.parse.bot/scraper/3313b917-e6fd-4f12-affa-3f1888f5cfa9/search_products?page=1&sort=relevance&query=laptop' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products across all categories on Coolblue. Returns paginated product results matching the query.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination |
| sort | string | Sort order. Accepted values: relevance, price_asc, price_desc, newest, rating |
| queryrequired | string | Search keyword |
{
"type": "object",
"fields": {
"url": "string URL that was fetched",
"total": "integer total number of matching products",
"products": "array of product objects with name, url, product_id, slug, price, highlights, and optional rating/reviews_count"
},
"sample": {
"data": {
"url": "https://www.coolblue.nl/en/search?q=laptop&page=1&sort=relevance",
"total": 186,
"products": [
{
"url": "https://www.coolblue.nl/en/product/963044/vortech-pro-gaming-chair-black.html",
"name": "Vortech Pro Gaming Chair Black",
"slug": "vortech-pro-gaming-chair-black",
"price": 269,
"price_str": "269,-",
"highlights": [
"Our choice for a gaming chair with many adjustment options"
],
"product_id": "963044",
"reviews_count": 4,
"reviews_count_str": "4 reviews"
}
]
},
"status": "success"
}
}About the coolblue.nl API
The Coolblue.nl API exposes 8 endpoints covering product search, laptop category browsing, detailed specifications, customer reviews, and refurbished listings from Coolblue.nl. The get_laptop_details endpoint returns structured key-value specification pairs for any laptop identified by its slug and product ID. Other endpoints cover brand-filtered browsing across Apple, Lenovo, HP, and five other manufacturers, plus a dedicated second-chance listings feed with condition information.
Search and Browse
The search_products endpoint accepts a query string and returns paginated results across all Coolblue categories, each product carrying name, url, product_id, slug, price, and highlights, with optional rating and reviews_count when available. The search_laptops endpoint targets the laptop category specifically and adds enriched fields — processor, screen_size, and os — on top of the base product shape. Both endpoints accept a sort parameter with values relevance, price_asc, price_desc, newest, and rating.
Category and Brand Filters
get_laptop_listings_by_category accepts a category path from options including laptops, windows-laptops, apple-macbook, gaming-laptops, and chromebook-models. get_laptop_listings_by_brand requires a brand parameter accepting eight values: apple, hp, lenovo, acer, asus, microsoft, msi, and samsung. Both return the same paginated product array shape with optional highlights, ratings, and review counts.
Details and Reviews
get_laptop_details takes a slug and product_id — both obtainable from any listing endpoint — and returns a specifications object of key-value pairs covering the full technical spec sheet for that product. get_laptop_reviews returns paginated individual reviews with title, text, rating, author, date, pros, cons, votes_up, and votes_down, alongside aggregate fields: total_reviews, average_rating (out of 10), and a rating_categories array with per-dimension averages.
New and Refurbished Listings
get_new_laptops returns the most recently added laptops sorted by addition date, useful for tracking catalog updates. get_affordable_second_chance returns refurbished laptop listings where the highlights array includes condition descriptors, allowing consumers to distinguish product quality tiers in Coolblue's second-chance inventory.
- Compare laptop prices across brands by combining
get_laptop_listings_by_brandresults for Apple, Lenovo, and HP. - Track newly added laptop models by polling
get_new_laptopsand diffing against a stored product list. - Build a refurbished laptop finder using
get_affordable_second_chancewith condition data from the highlights field. - Aggregate customer sentiment by fetching
get_laptop_reviewsand computing per-dimension averages fromrating_categories. - Populate a spec comparison table by calling
get_laptop_detailsfor multiple product slugs and merging theirspecificationsobjects. - Monitor price trends across categories by periodically querying
get_laptop_listings_by_categorywithsort=price_asc. - Filter gaming laptops by rating using
get_laptop_listings_by_categorywithcategory=gaming-laptopsandsort=rating.
| 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_laptop_details` return compared to a listing endpoint?+
get_laptop_details returns a specifications object with detailed key-value pairs covering the full technical spec sheet — fields like CPU model, RAM, storage, display resolution, and battery capacity that are not present in listing endpoints. Listing endpoints return summary fields such as price, highlights, and optional processor/screen_size/os from search_laptops.Are categories outside laptops covered by the browse endpoints?+
get_laptop_listings_by_category, get_laptop_listings_by_brand, get_new_laptops, get_affordable_second_chance) are scoped to laptops only. search_products covers all Coolblue categories via keyword search. You can fork this API on Parse and revise it to add browse endpoints for other product categories such as televisions or smartphones.Does the reviews endpoint return seller or third-party reviews?+
get_laptop_reviews endpoint returns Coolblue customer reviews only. Each review object includes author, date, rating, pros, cons, votes_up, and votes_down. It does not return reviews from external platforms. You can fork this API on Parse and revise it to add an endpoint pulling review data from another source if cross-platform aggregation is needed.Is there a way to filter search results by price range?+
search_products and search_laptops endpoints support sorting by price_asc or price_desc but do not accept minimum or maximum price parameters. Results can be sorted by price but not bounded to a range on the API side. You can fork this API on Parse and revise it to add price range filtering logic.