# Coolblue Product

## Overview

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

## Description

Get full Coolblue product details by URL: price, advised price, rating, full specs, photo gallery, stock per store, and energy label as structured JSON.

## 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/product' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Lookup by Coolblue product URL

```json
{
  "id": "968961",
  "ean": "194253712345",
  "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 zonder haperen",
    "Maak scherpe selfies van heel je vriendengroep",
    "Scrollen en gamen voelt snel en vloeiend",
    "Krijg minimaal 5 jaar iOS updates van Apple"
  ],
  "brand": "Apple",
  "media": {
    "images": [
      "https://image.coolblue.nl/products/968961/full/01.jpg",
      "https://image.coolblue.nl/products/968961/full/02.jpg",
      "https://image.coolblue.nl/products/968961/full/03.jpg",
      "https://image.coolblue.nl/products/968961/full/04.jpg"
    ],
    "video_urls": [
      "https://media.coolblue.nl/videos/968961/main.mp4"
    ],
    "energy_label_url": null,
    "product_data_sheet_url": "https://product-energy-label-specifications.coolblue.de/c3/produkt_daten_blatt_968961.pdf"
  },
  "specs": {
    "battery": {
      "wired_w": 40,
      "wireless_w": 25,
      "capacity_mah": 3692,
      "battery_after_30min": "Tussen 51% en 60%",
      "fast_charge_protocol": "Power Delivery 3.0"
    },
    "display": {
      "hdr": [
        "Dolby Vision",
        "HDR10"
      ],
      "type": "Super Retina XDR",
      "panel": "OLED",
      "quality": "Uitstekend",
      "diagonal_inch": 6.3,
      "refresh_rate_hz": 120,
      "pixel_density_ppi": 458
    },
    "general": {
      "type": "Smartphone",
      "sat_value": "1,2 W/kg (D)",
      "recommended_use": "Bellen en Whatsapp, Films en series kijken, Gaming, Internet, social media"
    },
    "physical": {
      "size": "Gemiddeld",
      "color": "Zwart",
      "magsafe": true,
      "depth_cm": 0.795,
      "weight_g": 177,
      "width_cm": 7.15,
      "height_cm": 14.96,
      "ip_rating": "IP68"
    },
    "camera_back": {
      "video": "4K @ 60 FPS",
      "main_mp": 48,
      "secondary_mp": 48,
      "main_aperture": 1.6,
      "stabilization": "Optische Beeldstabilisatie",
      "secondary_aperture": 2.2
    },
    "camera_front": {
      "type": "In scherm",
      "aperture": 1.9,
      "megapixels": 18,
      "stabilization": "Optische Beeldstabilisatie"
    },
    "connectivity": {
      "nfc": true,
      "usb": "USB-C",
      "wifi": [
        "Wifi 7",
        "Wifi 6E",
        "Wifi 6",
        "Wifi 5"
      ],
      "internet": [
        "4G",
        "5G"
      ],
      "bluetooth": "6.0"
    },
    "operating_system": {
      "intro_year": 2025,
      "latest_ios": "iOS 26",
      "intro_month": "September",
      "operating_system": "iOS",
      "ios_version_at_launch": "iOS 26",
      "remaining_ios_updates": 6,
      "security_updates_until": "September 2030"
    },
    "processor_memory": {
      "ram_gb": 8,
      "processor": "A19 Bionic-chip",
      "storage_gb": 256,
      "speed_class": "Uitstekend"
    }
  },
  "title": "Apple iPhone 17 256GB Zwart",
  "country": "nl",
  "pricing": {
    "price": 909,
    "currency": "EUR",
    "advised_price": 969,
    "trade_in_price": 549,
    "discount_percent": 6.2
  },
  "reviews": {
    "rating": 9.1,
    "distribution": {
      "1": 0,
      "2": 0,
      "3": 0,
      "4": 0,
      "5": 0,
      "6": 1,
      "7": 2,
      "8": 5,
      "9": 9,
      "10": 21
    },
    "review_count": 38
  },
  "variants": [
    {
      "id": "968963",
      "url": "https://www.coolblue.nl/product/968963/apple-iphone-17-256gb-wit.html",
      "price": 909,
      "title": "Apple iPhone 17 256GB Wit"
    },
    {
      "id": "968965",
      "url": "https://www.coolblue.nl/product/968965/apple-iphone-17-512gb-zwart.html",
      "price": 1109,
      "title": "Apple iPhone 17 512GB Zwart"
    },
    {
      "id": "968967",
      "url": "https://www.coolblue.nl/product/968967/apple-iphone-17-512gb-wit.html",
      "price": 1109,
      "title": "Apple iPhone 17 512GB Wit"
    }
  ],
  "description": "iPhone 17 reageert altijd snel, zelfs wanneer je veel zware apps tegelijk gebruikt. Dit kleine toestel past goed in je zak. Op het 6,3 inch OLED scherm zie je elk detail, of je nu een serie kijkt of foto's bewerkt.\n\nDe 48 MP hoofdcamera met groothoeklens maakt scherpe foto's bij elk licht. De A19 Bionic-chip houdt de zwaarste apps en games soepel.",
  "availability": {
    "stores": [
      {
        "city": "Rotterdam",
        "store": "Coolblue Rotterdam Alexandrium",
        "same_day_pickup": true
      },
      {
        "city": "Amsterdam",
        "store": "Coolblue Amsterdam ArenA",
        "same_day_pickup": true
      },
      {
        "city": "Utrecht",
        "store": "Coolblue Utrecht",
        "same_day_pickup": true
      },
      {
        "city": "Eindhoven",
        "store": "Coolblue Eindhoven",
        "same_day_pickup": false
      }
    ],
    "in_stock": true,
    "delivery_date": "2026-05-19T00:00:00.000Z",
    "delivery_text": "Voor 23.59 uur besteld, morgen gratis bezorgd",
    "store_pickup_locations": 21
  },
  "category_path": [
    "Mobiele telefoons",
    "Smartphones",
    "Apple iPhone",
    "Apple iPhone 17"
  ],
  "manufacturer_code": "MG6J4ZD/A"
}
```

## Documentation

## Overview

Coolblue is the Dutch and Belgian e-commerce leader for consumer electronics and home appliances. The product endpoint returns the full PDP parsed as JSON: title, brand, manufacturer code, EAN, long-form description, USP bullets, current and advised price, trade-in price, 10-point rating with review distribution, delivery promise, per-store pickup availability, sibling variants, the full Coolblue spec sheet, full-resolution images, video, and the EU energy label PDF when relevant. The site uses Cloudflare with bot detection. Piloterr handles the challenge.

## Quickstart

```
GET https://api.piloterr.com/v2/coolblue/product?query=https://www.coolblue.nl/product/968961/apple-iphone-17-256gb-zwart.html
```

## Main use cases

- Power a price-tracking alert that watches selling price vs. advised retail and notifies users on target discounts
- Feed a competitive intelligence dashboard for brands tracking Coolblue price, stock, and rating against their own performance
- Sync the full spec sheet into a product comparison engine for an electronics affiliate site
- Calculate effective net cost using trade-in, advised price, and current price for buy-back marketplaces
- Monitor rating and review distribution over time to catch quality issues on launch

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