# Coolblue Scraper: Products, Prices, Ratings & Stock (`getascraper/coolblue-scraper`) Actor Extract live prices, ratings, stock status, promo badges, and Tweedekans open-box deals from Coolblue (NL, BE, DE). Search by keyword or browse any category page. - **URL**: https://apify.com/getascraper/coolblue-scraper.md - **Developed by:** [GetAScraper](https://apify.com/getascraper) (community) - **Categories:** E-commerce, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## 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/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. Actors are written with capital "A". ## 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. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Coolblue Scraper: Products, Prices, Ratings & Stock Track every product on [Coolblue](https://www.coolblue.nl/) β€” the Netherlands' NΒΊ1 electronics retailer β€” in minutes. This scraper pulls **live prices, ratings, stock status, specifications, promo badges, and open-box Tweedekans deals** into a clean spreadsheet or data feed, across all three Coolblue regions (Netherlands, Belgium, Germany). 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 collects product listings from Coolblue and returns structured records you can analyse straight away. Each record includes the product title, current price, community rating, review count, stock availability, key specifications, promo badge text, and a direct link to the Coolblue product page. You can search a keyword like "laptop" or "wasmachine", point it at a specific category page, sort by price or popularity, and optionally enrich each card with bullet highlights and Tweedekans open-box alternative pricing. The scraper handles pagination and stops exactly at the result limit you set. Running on Apify means you also get scheduling, a full API, ready integrations (Google Sheets, Make, Zapier, Slack), automatic proxy rotation, and run monitoring out of the box. ### Why use Coolblue Scraper? - **Competitive price monitoring.** Track how Coolblue prices a category week over week and benchmark against your own store or supplier costs. - **Reselling and arbitrage.** Spot underpriced Tweedekans open-box deals before they sell out, complete with the open-box URL and price in the same record. - **Market and category research.** Understand which products dominate search results, how ratings distribute across a category, and which promos are running. - **Affiliate and content workflows.** Pull a ranked list of the best-rated products in a niche and feed it straight into a deal page, newsletter, or price comparison tool. - **Multi-region coverage.** Scrape coolblue.nl, coolblue.be, and coolblue.de in any language (Dutch, English, French, German) from the same input form. ### How to use Coolblue Scraper to extract products 1. Click **Try for free**. 2. Choose a **Scraping mode**: Search by Keyword or Browse Category URL. 3. Enter your **keyword** (in Search mode) or paste a **category URL** (in Category mode). 4. Select the **Coolblue domain** (Netherlands, Belgium, or Germany) and your preferred language. 5. Optionally set a sort order and toggle the enrichment fields you need. 6. Set a **Maximum listings** limit to control run size. 7. Click **Save & Start**. 8. When the run finishes, preview the results and export to JSON, CSV, Excel, or Google Sheets. ### 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", "price": 2949.0, "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. | | price | number | Current selling price in EUR. | | 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. ### 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. **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. # 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": 100, "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 '' with your token const client = new ApifyClient({ 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": 100, "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 '' with your token. client = ApifyClient("") # 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": 100, "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("πŸ’Ύ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).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": 100, "proxyConfiguration": { "useApifyProxy": true } }' | apify call getascraper/coolblue-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=getascraper/coolblue-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Coolblue Scraper: Products, Prices, Ratings & Stock", "description": "Extract live prices, ratings, stock status, promo badges, and Tweedekans open-box deals from Coolblue (NL, BE, DE). Search by keyword or browse any category page.", "version": "0.1", "x-build-id": "5ILEKCNcyjwGhcdB5" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getascraper~coolblue-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getascraper-coolblue-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/getascraper~coolblue-scraper/runs": { "post": { "operationId": "runs-sync-getascraper-coolblue-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/getascraper~coolblue-scraper/run-sync": { "post": { "operationId": "run-sync-getascraper-coolblue-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "mode": { "title": "Scraping Mode", "enum": [ "search", "category" ], "type": "string", "description": "Select how to find items: search by keyword query or browse a direct category URL.", "default": "search" }, "domain": { "title": "Coolblue Domain", "enum": [ "coolblue.nl", "coolblue.be", "coolblue.de" ], "type": "string", "description": "Choose the target regional Coolblue country domain to crawl.", "default": "coolblue.nl" }, "language": { "title": "Language", "enum": [ "nl", "en", "fr", "de" ], "type": "string", "description": "Choose the language subpath to scrape.", "default": "nl" }, "keywords": { "title": "Search Keywords", "type": "string", "description": "The search query term to look up across Coolblue (only applicable in search mode).", "default": "" }, "categoryUrl": { "title": "Category URL", "type": "string", "description": "The direct category listing URL to crawl (e.g. https://www.coolblue.nl/laptops/apple-macbook). Only applicable in category mode.", "default": "" }, "sort": { "title": "Sort Order", "enum": [ "relevantie", "best-beoordeeld", "laagste-prijs", "hoogste-prijs", "best-verkocht" ], "type": "string", "description": "Choose how products are ordered on search or catalog listing pages.", "default": "relevantie" }, "includeSpecs": { "title": "Extract Specifications", "type": "boolean", "description": "Extract product highlight specifications displayed on listing cards.", "default": true }, "includeBullets": { "title": "Extract Pros and Cons", "type": "boolean", "description": "Extract product key highlight bullet points.", "default": true }, "includePromo": { "title": "Extract Promo Badges", "type": "boolean", "description": "Extract promotional badges and campaign text.", "default": true }, "includeSecondChance": { "title": "Extract Second Chance Offerings", "type": "boolean", "description": "Extract cheaper Tweedekans open-box URLs and prices.", "default": true }, "maxItems": { "title": "Maximum Listings Limit", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum total product records to extract during this crawl run.", "default": 100 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings. Default rotating proxies work reliably for Coolblue.", "default": { "useApifyProxy": true } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```