# Coolblue Scraper: Live Prices, Stock, Ratings & Open-Box Deals (`getascraper/coolblue-scraper`) Actor

Extract live prices, stock status, community ratings, specs, promo badges, and Tweedekans open-box deals from Coolblue across the Netherlands, Belgium, and Germany. Search by keyword or browse any category page. Export to Google Sheets, Make, Zapier, or your own pipeline via the API.

- **URL**: https://apify.com/getascraper/coolblue-scraper.md
- **Developed by:** [GetAScraper](https://apify.com/getascraper) (community)
- **Categories:** E-commerce, Automation
- **Features:** Limited permissions
- **Stats:** 8 total users, 3 monthly users, 98.6% runs succeeded, 0 bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

from $1.88 / 1,000 product records

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## 🛒 Coolblue Scraper: Live Prices, Stock, Ratings & Open-Box Deals

<table width="100%" style="display:table;width:100%;border-collapse:separate;border-spacing:0;margin-bottom:0">
<tr>
<td style="padding:24px 28px;background:#EAF1FC;border:1px solid #C7DBF7;border-top:4px solid #1557D0;color:#1C1917;border-radius:10px 10px 0 0">
<span style="font-size:23px;font-weight:800;color:#1C1917;line-height:1.3">Get live Coolblue prices, stock, and open-box deals ready for your spreadsheet in minutes.</span><br>
<span style="font-size:15px;color:#57534E;line-height:1.6">Search any keyword or paste a category link across coolblue.nl, coolblue.be, and coolblue.de. Get ratings, promo badges, and Tweedekans open-box pricing back as clean, structured data.</span>
</td>
</tr>
</table>
<table width="100%" style="display:table;width:100%;border-collapse:separate;border-spacing:0;margin-top:0">
<tr>
<td style="padding:14px 12px;width:25%;background:#FFFFFF;border:1px solid #C7DBF7;vertical-align:top;border-top:none;color:#1C1917;border-radius:0 0 0 10px">
<span style="font-size:15px;font-weight:800;color:#0E3F99">🌍 Three stores, one run</span><br>
<span style="font-size:12px;color:#57534E">Covers coolblue.nl, coolblue.be, and coolblue.de from a single input form.</span>
</td>
<td style="padding:14px 12px;width:25%;background:#FFFFFF;border:1px solid #C7DBF7;border-left:none;vertical-align:top;border-top:none;color:#1C1917">
<span style="font-size:15px;font-weight:800;color:#0E3F99">⚡ No extra page visits</span><br>
<span style="font-size:12px;color:#57534E">Specs, bullets, and promo badges come straight off the listing page.</span>
</td>
<td style="padding:14px 12px;width:25%;background:#FFFFFF;border:1px solid #C7DBF7;border-left:none;vertical-align:top;border-top:none;color:#1C1917">
<span style="font-size:15px;font-weight:800;color:#0E3F99">♻️ Open-box pricing</span><br>
<span style="font-size:12px;color:#57534E">Tweedekans alternative price and link included when available.</span>
</td>
<td style="padding:14px 12px;width:25%;background:#FFFFFF;border:1px solid #C7DBF7;border-left:none;vertical-align:top;border-top:none;color:#1C1917;border-radius:0 0 10px 0">
<span style="font-size:15px;font-weight:800;color:#0E3F99">⭐ Ratings included</span><br>
<span style="font-size:12px;color:#57534E">Community rating and review count on every product by default.</span>
</td>
</tr>
</table>

Search by keyword, browse a category, or paste any Coolblue listing page. Export to JSON, CSV, Excel, or Google Sheets.

### 🔍 What does Coolblue Scraper do?

It reads product listings from Coolblue, one of the Netherlands' largest electronics retailers, and returns structured records for every item it finds. Each record includes the product title, brand, current price, original "was" price and discount when an item is on sale, community rating, review count, stock status, key specifications, promo badge text, Tweedekans open-box pricing when available, and a direct link to the product page.

Search a keyword like "laptop" or "wasmachine", point it at any category page, or set a sort order. All of it comes directly from the same listing page: specs, bullets, promo badges, and open-box pricing. No extra visit to each product page, so runs stay fast and reliable.

Running on Apify also gets you scheduling, a full API, ready integrations with Google Sheets, Make, Zapier, and Slack, automatic proxy rotation, and run monitoring, all included.

### 🎯 Why use Coolblue Scraper?

- **I am a reseller** looking to track Coolblue's Tweedekans open-box deals in order to resell underpriced refurbished electronics before they sell out.
- **I am a price analyst** looking to benchmark Coolblue against my own store across the Netherlands, Belgium, and Germany in order to keep my pricing competitive.
- **I am an affiliate site owner** looking to build a ranked list of Coolblue's best-rated products in order to turn it into a deal page or newsletter.
- **I am a market researcher** looking to compare pricing and ratings across Coolblue's three regional stores in order to spot regional pricing gaps.

### 🚀 How to use Coolblue Scraper to extract products

<table width="100%" style="display:table;width:100%;border-collapse:separate;border-spacing:0">
<tr>
<td style="padding:16px 14px;width:33%;background:#EAF1FC;border:1px solid #C7DBF7;border-radius:10px 0 0 10px;vertical-align:top;color:#1C1917">
<span style="font-size:12px;font-weight:800;color:#1557D0;letter-spacing:1px">STEP 1</span><br>
<span style="font-size:14px;font-weight:700;color:#1C1917">Pick a region and search</span><br>
<span style="font-size:12px;color:#57534E">Choose coolblue.nl, .be, or .de, then search a keyword or paste a category URL.</span>
</td>
<td style="padding:16px 14px;width:33%;background:#EAF1FC;border:1px solid #C7DBF7;border-left:none;vertical-align:top;color:#1C1917">
<span style="font-size:12px;font-weight:800;color:#1557D0;letter-spacing:1px">STEP 2</span><br>
<span style="font-size:14px;font-weight:700;color:#1C1917">Toggle your fields</span><br>
<span style="font-size:12px;color:#57534E">Keep specs, bullets, promo badges, and Tweedekans pricing on or off, and set a result limit.</span>
</td>
<td style="padding:16px 14px;width:33%;background:#EAF1FC;border:1px solid #C7DBF7;border-left:none;border-radius:0 10px 10px 0;vertical-align:top;color:#1C1917">
<span style="font-size:12px;font-weight:800;color:#1557D0;letter-spacing:1px">STEP 3</span><br>
<span style="font-size:14px;font-weight:700;color:#1C1917">Run and export</span><br>
<span style="font-size:12px;color:#57534E">Start the run, then export to JSON, CSV, Excel, or Google Sheets.</span>
</td>
</tr>
</table>

### 📋 Input

Configure the scraper from the Apify Console form or pass the same fields as JSON. Every field is optional, so a run with only keywords set scrapes the first 100 matching products from coolblue.nl.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| mode | enum | No | How to find products: Search by Keyword or Browse Category URL. Defaults to Search. |
| domain | enum | No | Regional Coolblue domain to scrape: coolblue.nl (Netherlands), coolblue.be (Belgium), or coolblue.de (Germany). Defaults to coolblue.nl. |
| language | enum | No | Language subpath: nl (Dutch), en (English), fr (French), or de (German). Defaults to nl. |
| keywords | string | No | Search term to look up across Coolblue. Required in Search mode. |
| categoryUrl | string | No | Direct category listing URL to crawl, for example https://www.coolblue.nl/laptops/apple-macbook. Required in Category mode. |
| sort | enum | No | Product ordering: Relevance, Best Reviewed, Price Low to High, Price High to Low, or Most Popular. Defaults to Relevance. |
| includeSpecs | boolean | No | Extract specification highlights shown on each product card. Defaults to true. |
| includeBullets | boolean | No | Extract product bullet highlights. Defaults to true. |
| includePromo | boolean | No | Extract promotional badge text and campaign labels. Defaults to true. |
| includeSecondChance | boolean | No | Extract Tweedekans open-box alternative URL and price when available. Defaults to true. |
| maxItems | integer | No | Maximum number of products to collect in one run. Defaults to 100. |
| proxyConfiguration | proxy object | No | Proxy settings. Rotating datacenter proxies are the default and work reliably for Coolblue. |

### 📤 Output

Results are returned as a structured dataset. You can download the dataset in various formats such as JSON, HTML, CSV, or Excel. Here is a simplified example of one product record:

```json
{
  "product_id": "976911",
  "title": "Apple MacBook Pro 14 inch M5 Pro (15 CPU / 16 GPU) 24GB/1TB Zwart QWERTY",
  "brand": "Apple",
  "price": 2949.0,
  "list_price": 3199.0,
  "discount_amount": 250.0,
  "discount_percent": 8,
  "on_sale": true,
  "currency": "EUR",
  "rating_score": 9.6,
  "reviews_count": 20,
  "in_stock": true,
  "specifications": ["MacBook Pro", "2026", "14 inch (36 cm)"],
  "bullet_highlights": ["Ultra-thin design", "18-hour battery life"],
  "promo_text": "tot € 450,- inruilwaarde",
  "second_chance_price": 2891.0,
  "second_chance_url": "https://www.coolblue.nl/tweedekans-product/2994680",
  "image_url": "https://image.coolblue.nl/transparent/max/320xauto/products/1730017064",
  "view_item_url": "https://www.coolblue.nl/product/976911/apple-macbook-pro-14-inch.html",
  "scraped_at": "2026-06-27T09:00:00.000Z"
}
```

### 📊 Data table

| Field | Type | Description |
| --- | --- | --- |
| product_id | string | Unique Coolblue product identifier. |
| title | string | Full product title as shown on the listing. |
| brand | string | Product brand, when identifiable from the title. |
| price | number | Current selling price in EUR. |
| list_price | number | Original "was" price shown on discounted items, when present. |
| discount_amount | number | Money saved versus the original price, when on sale. |
| discount_percent | number | Percentage off the original price, when on sale. |
| on_sale | boolean | Whether the item is currently discounted. |
| currency | string | Currency code, always EUR. |
| rating_score | number | Community rating out of 10. |
| reviews_count | number | Total number of customer reviews. |
| in_stock | boolean | Whether the product is currently available. |
| specifications | array of strings | Key specification highlights shown on the product card. |
| bullet_highlights | array of strings | Short selling-point bullets for the product. |
| promo_text | string | Active promotional badge or campaign label, when present. |
| second_chance_price | number | Tweedekans open-box price, when available. |
| second_chance_url | string | Link to the Tweedekans open-box listing, when available. |
| image_url | string | Main product image link. |
| view_item_url | string | Direct link to the product page on Coolblue. |
| scraped_at | string | Extraction time in ISO 8601 format. |

### 💰 Pricing

This Actor runs on the pay per result model. You pay only for the products you collect, empty runs cost nothing, and there are no monthly subscriptions. Set a maximum listings limit to keep every run within budget. The first results are free to try.

### ⭐ Enjoying Coolblue Scraper?

<table width="100%" style="display:table;width:100%;border-collapse:separate;border-spacing:0">
<tr>
<td style="padding:20px 24px 14px;background:#EAF1FC;border:1px solid #C7DBF7;border-left:5px solid #1557D0;border-radius:10px 10px 0 0;color:#1C1917">
<span style="font-size:20px;letter-spacing:4px">⭐ ⭐ ⭐ ⭐ ⭐</span><br>
<span style="font-size:17px;font-weight:800;color:#1C1917">One scheduled run replaces hours of manually rechecking Coolblue listings for price drops, stock changes, and new open-box deals.</span><br>
<span style="font-size:14px;color:#57534E">A 5-star rating takes 10 seconds and helps other resellers and price trackers find this actor. Your feedback also tells us what to build next.</span>
</td>
</tr>
<tr>
<td style="padding:0;background:#1557D0;border:1px solid #1557D0;border-left:5px solid #1557D0;border-top:none;border-radius:0 0 10px 10px;text-align:center;color:#FFFFFF">
<a href="https://apify.com/getascraper/coolblue-scraper/reviews" style="display:block;padding:13px 16px;color:#FFFFFF;text-decoration:none;font-weight:800;font-size:15px;letter-spacing:0.3px">★&nbsp;&nbsp;Rate this Actor on Apify</a>
</td>
</tr>
</table>

### 💡 Tips and advanced options

- **Search vs category.** Use Search mode for broad market sweeps. Use Category mode to monitor a specific segment, for example all NL laptops under a brand page, with guaranteed scope.
- **Sort by best-reviewed.** Set sort to Best Reviewed to surface the top-rated products in a category first and stop early, keeping runs cheap.
- **Extract Tweedekans deals.** Keep includeSecondChance enabled to capture open-box pricing and URLs in the same record as the new price. Useful for arbitrage and resale margin calculations.
- **Run multi-region in parallel.** Start one run per domain (nl, be, de) in parallel to compare regional pricing across Coolblue's three markets.
- **Schedule it.** Run the scraper on a weekly schedule to build a price and availability history over time for trend analysis.
- **Limit by maxItems.** Set a small limit (20 to 50) for a quick spot check, or leave it high for a full category sweep.

### ❓ Frequently asked questions

**Is it legal to scrape Coolblue?**
Scraping publicly available product data is generally legal in most jurisdictions. This scraper collects only public listing information and no private account data. You are responsible for how you use the data and for following Coolblue's terms and applicable laws.

**Do I need a Coolblue account or login?**
No. The scraper reads public product listing pages, so no Coolblue account or password is needed.

**Does the scraper get blocked by Coolblue?**
It uses Apify's proxy network with automatic rotation and built-in retries, so blocks are rare. For very high-volume runs, you can switch to residential proxies in the Proxy Configuration field for extra reliability.

**Can I scrape a specific brand or category page?**
Yes. Paste any Coolblue category, brand, or filtered listing URL into the Category URL field and the scraper will read it directly, including pagination.

**Why did some products come back without a price?**
A small number of Coolblue listings show "Prijs op aanvraag" (price on request) or are display-only. The scraper sets price to null for these and still captures the title and product URL.

**How many products can I collect?**
As many as the category contains, up to your maximum listings limit. Most Coolblue category pages have 24 products per page and support up to 50 pages.

### 🛟 Support

Found a problem or need a field that is missing? Open an issue on the Actor's Issues tab. Custom scraping solutions are available on request.

### 🔗 Other actors

- [de Bijenkorf scraper](https://apify.com/getascraper/debijenkorf-scraper) ↗ - tracks products, prices, and stock on the Dutch department store de Bijenkorf.
- [eMAG Price Monitor: Monitorizare Prețuri eMAG (Romania)](https://apify.com/getascraper/emag-price-monitor) ↗ - monitors price and stock changes on Romania's largest online retailer.
- [Falabella Price Monitor: Alerta de Precios (Chile, Peru, Colombia)](https://apify.com/getascraper/falabella-price-monitor) ↗ - tracks price and stock changes across Falabella's Latin American stores.
- [Trendyol Price Monitor: Fiyat Takibi (Türkiye)](https://apify.com/getascraper/trendyol-price-monitor) ↗ - monitors price changes on Turkey's largest e-commerce marketplace.

# Changelog

This Actor's version history is a separate document: https://apify.com/getascraper/coolblue-scraper/changelog.md

# Actor input Schema

## `mode` (type: `string`):

Select how to find items: search by keyword query or browse a direct category URL.

## `domain` (type: `string`):

Choose the target regional Coolblue country domain to crawl.

## `language` (type: `string`):

Choose the language subpath to scrape.

## `keywords` (type: `string`):

The search query term to look up across Coolblue (only applicable in search mode).

## `categoryUrl` (type: `string`):

The direct category listing URL to crawl (e.g. https://www.coolblue.nl/laptops/apple-macbook). Only applicable in category mode.

## `sort` (type: `string`):

Choose how products are ordered on search or catalog listing pages.

## `includeSpecs` (type: `boolean`):

Extract product highlight specifications displayed on listing cards.

## `includeBullets` (type: `boolean`):

Extract product key highlight bullet points.

## `includePromo` (type: `boolean`):

Extract promotional badges and campaign text.

## `includeSecondChance` (type: `boolean`):

Extract cheaper Tweedekans open-box URLs and prices.

## `maxItems` (type: `integer`):

Maximum total product records to extract during this crawl run.

## `proxyConfiguration` (type: `object`):

Proxy settings. Default rotating proxies work reliably for Coolblue.

## Actor input object example

```json
{
  "mode": "search",
  "domain": "coolblue.nl",
  "language": "nl",
  "keywords": "macbook",
  "categoryUrl": "",
  "sort": "relevantie",
  "includeSpecs": true,
  "includeBullets": true,
  "includePromo": true,
  "includeSecondChance": true,
  "maxItems": 50,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `dataset` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "mode": "search",
    "domain": "coolblue.nl",
    "language": "nl",
    "keywords": "macbook",
    "categoryUrl": "",
    "sort": "relevantie",
    "includeSpecs": true,
    "includeBullets": true,
    "includePromo": true,
    "includeSecondChance": true,
    "maxItems": 50,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("getascraper/coolblue-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "mode": "search",
    "domain": "coolblue.nl",
    "language": "nl",
    "keywords": "macbook",
    "categoryUrl": "",
    "sort": "relevantie",
    "includeSpecs": True,
    "includeBullets": True,
    "includePromo": True,
    "includeSecondChance": True,
    "maxItems": 50,
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("getascraper/coolblue-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "mode": "search",
  "domain": "coolblue.nl",
  "language": "nl",
  "keywords": "macbook",
  "categoryUrl": "",
  "sort": "relevantie",
  "includeSpecs": true,
  "includeBullets": true,
  "includePromo": true,
  "includeSecondChance": true,
  "maxItems": 50,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call getascraper/coolblue-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,getascraper/coolblue-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/fukgJw9H7lavkzqrx/builds/S21TL7aJLDHUwI1EA/openapi.json