{ "openapi": "3.0.1", "info": { "title": "Bol.com Scraper", "description": "Scrape bol.com (NL/BE) products: prices, EAN-13, ratings, sellers, variants, full specifications, complete reviews and every seller offer.", "version": "0.0", "x-build-id": "uAYE5s12YDVnQQzQ5" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/unfenced-group~bol-com-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-unfenced-group-bol-com-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/unfenced-group~bol-com-scraper/runs": { "post": { "operationId": "runs-sync-unfenced-group-bol-com-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/unfenced-group~bol-com-scraper/run-sync": { "post": { "operationId": "run-sync-unfenced-group-bol-com-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": { "searchQuery": { "title": "Search query", "type": "string", "description": "A single keyword to search on bol.com (e.g. 'koffie', 'lego', 'airpods'). Becomes a /s/?searchtext= URL on the selected shop." }, "searchQueries": { "title": "Search queries (multiple)", "type": "array", "description": "Several keywords to search in one run. Each becomes its own search.", "default": [], "items": { "type": "string" } }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Bol.com URLs to crawl. Supported: search (/s/), category (/l/), brand (/pb/), series (/serie/) and product detail (/p/) pages, on either www.bol.com/nl/nl/ or www.bol.com/be/nl/.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "country": { "title": "Country shop", "enum": [ "nl", "be" ], "type": "string", "description": "Which bol.com shop to use for keyword searches. Also pins the residential proxy country when fallback is needed. Start URLs keep their own /nl/ or /be/ path.", "default": "nl" }, "maxResults": { "title": "Max results", "minimum": 0, "type": "integer", "description": "Overall ceiling on items pushed across all sources (search queries + start URLs combined). Use 0 for unlimited.", "default": 50 }, "maxResultsPerUrl": { "title": "Max results per source", "minimum": 0, "type": "integer", "description": "Optional per-source cap. Each search query and each start URL stops after this many items, while 'Max results' still applies as the overall ceiling. Use 0 to apply no per-source limit. Useful when crawling several URLs in one run so the first source does not consume the whole budget.", "default": 0 }, "includeVariantPrices": { "title": "Include variant prices", "type": "boolean", "description": "Add the per-variant list (each variant's EAN-13, price, condition and availability) to every product, without pulling the full detail enrichment. Visits the product detail page. Ignored when 'Fetch product detail pages' is already on, since variants are included there.", "default": false }, "fetchDetails": { "title": "Fetch product detail pages", "type": "boolean", "description": "Visit each product's detail page to add per-variant EAN-13, brand, weight, condition, buy-box price range, full image set, specifications and a review sample. Slower and billed at the higher detail rate.", "default": false }, "fetchReviews": { "title": "Fetch full reviews", "type": "boolean", "description": "Collect the full customer review list per product (rating, title, body, date, helpful count) plus the rating distribution. Visits the detail page; billed per product that returns reviews.", "default": false }, "fetchOffers": { "title": "Fetch all seller offers", "type": "boolean", "description": "Collect every seller's offer for each product (seller, price, condition, delivery), not just the buy-box winner. Visits the detail page; billed per product that returns offers.", "default": false }, "maxReviewsPerProduct": { "title": "Max reviews per product", "minimum": 1, "type": "integer", "description": "Cap on reviews collected per product when 'Fetch full reviews' is on.", "default": 50 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional. Leave empty to start without a proxy — the scraper escalates to Apify Residential (country-pinned) automatically only if bol.com blocks the request. Set this to force a proxy from the start.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } }