# Coolblue Search

## Overview

| Property | Value |
|----------|-------|
| **Status** | private |
| **Method** | `GET` |
| **Endpoint** | `/v2/coolblue/search` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/coolblue-search |

## Description

Search Coolblue Netherlands and Belgium product catalog by keyword and return product title, price, advised price, rating, and stock as structured JSON in real time.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/coolblue/search' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Search by keyword 'iphone 17'

```json
{
  "page": 1,
  "country": "nl",
  "results": [
    {
      "id": "968961",
      "url": "https://www.coolblue.nl/product/968961/apple-iphone-17-256gb-zwart.html",
      "usp": [
        "Je bedient dit kleine toestel makkelijk met 1 hand",
        "Gebruik de zwaarste apps en games",
        "Maak scherpe selfies van heel je vriendengroep",
        "Scrollen en gamen voelt snel en vloeiend"
      ],
      "brand": "Apple",
      "price": 909,
      "title": "Apple iPhone 17 256GB Zwart",
      "badges": [
        "vakantiegeld_deal",
        "extra_inruilwaarde"
      ],
      "rating": 9.1,
      "category": "mobiele-telefoons",
      "currency": "EUR",
      "in_stock": true,
      "thumbnail": "https://image.coolblue.nl/products/968961/300x300/apple-iphone-17-256gb-zwart.jpg",
      "review_count": 38,
      "advised_price": 969,
      "delivery_text": "Morgen bezorgd",
      "discount_percent": 6.2,
      "store_pickup_locations": 21
    },
    {
      "id": "968966",
      "url": "https://www.coolblue.nl/product/968966/apple-iphone-17-pro-max-256gb-oranje.html",
      "usp": [
        "Op het grote scherm zie je elk detail van filmpjes",
        "Gebruik de zwaarste apps en games",
        "Maak scherpe selfies van heel je vriendengroep",
        "Zoom tot 8 keer in en maak groothoekfoto's"
      ],
      "brand": "Apple",
      "price": 1479,
      "title": "Apple iPhone 17 Pro Max 256GB Oranje",
      "badges": [
        "top_10"
      ],
      "rating": 9.4,
      "category": "mobiele-telefoons",
      "currency": "EUR",
      "in_stock": true,
      "thumbnail": "https://image.coolblue.nl/products/968966/300x300/apple-iphone-17-pro-max-256gb-oranje.jpg",
      "review_count": 17,
      "advised_price": 1479,
      "delivery_text": "Morgen bezorgd",
      "discount_percent": null,
      "store_pickup_locations": 18
    },
    {
      "id": "969443",
      "url": "https://www.coolblue.nl/product/969443/apple-iphone-17-pro-256gb-blauw.html",
      "usp": [
        "Je bedient dit kleine toestel makkelijk met 1 hand",
        "Gebruik de zwaarste apps en games",
        "Maak scherpe selfies van heel je vriendengroep",
        "Zoom tot 8 keer in en maak groothoekfoto's"
      ],
      "brand": "Apple",
      "price": 1329,
      "title": "Apple iPhone 17 Pro 256GB Blauw",
      "badges": [
        "top_10"
      ],
      "rating": 9.3,
      "category": "mobiele-telefoons",
      "currency": "EUR",
      "in_stock": true,
      "thumbnail": "https://image.coolblue.nl/products/969443/300x300/apple-iphone-17-pro-256gb-blauw.jpg",
      "review_count": 24,
      "advised_price": 1329,
      "delivery_text": "Morgen bezorgd",
      "discount_percent": null,
      "store_pickup_locations": 19
    }
  ],
  "total_results": 187,
  "results_per_page": 24
}
```

## Documentation

## Overview

Coolblue is the Dutch and Belgian e-commerce leader for consumer electronics and home appliances. The site uses Cloudflare with bot detection that throttles plain HTTP requests. Piloterr handles the Cloudflare challenge and parsing and returns each search page as paginated JSON: product number, brand, category, current price, advised retail price, customer rating on the 10-point scale, review count, next-day delivery flag, number of stores stocking the item, badges, and benefit bullets.

## Quickstart

```
GET https://api.piloterr.com/v2/coolblue/search?query=iphone+17&country=nl&min_rating=8
```

## Main use cases

- Track price drops on iPhone, Samsung, and Bosch SKUs hourly for a Dutch and Belgian price-comparison engine
- Monitor stock and store-pickup availability on hot launches to alert resellers the moment Coolblue replenishes
- Build a product reputation index for an electronics affiliate site using rating and review_count
- Map Coolblue's promotional calendar by reading badge data (vakantiegeld_deal, top_10, extra_inruilwaarde)
- Build a brand share dashboard inside specific Coolblue categories by counting products per brand

See https://www.piloterr.com/pricing for plans and free trial credits.