{ "openapi": "3.0.1", "info": { "title": "Coolblue Scraper: Live Prices, Stock, Ratings & Open-Box Deals", "description": "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.", "version": "0.1", "x-build-id": "9bYJ3Gp6vlFtsPEa2" }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }