# Bol.com Scraper — Dutch & Belgian Products & Prices (`studio-amba/bol-scraper`) Actor Scrape products, prices, ratings, and availability from Bol.com — the #1 online retailer in the Netherlands and Belgium. Supports search queries and category browsing. - **URL**: https://apify.com/studio-amba/bol-scraper.md - **Developed by:** [Studio Amba](https://apify.com/studio-amba) (community) - **Categories:** E-commerce - **Stats:** 1 total users, 0 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## 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 ## Bol.com Scraper Extract product data from [Bol.com](https://www.bol.com) — the #1 online retailer in the Netherlands and Belgium — into structured JSON with prices, ratings, specs, stock status, and seller info. ### What is Bol.com Scraper? **Bol.com Scraper** lets you extract structured e-commerce data from the largest online marketplace in the Benelux region, helping you monitor prices, analyze competitors, and build product databases — all without manual browsing. - **Track competitor pricing:** extract current and original prices across thousands of products to spot discounts, price drops, and margin opportunities in real time - **Monitor stock availability:** check which products are in stock, which sellers carry them, and get alerts when inventory changes - **Build product catalogs:** scrape full product details including specs, images, descriptions, and categories to populate your own catalog or comparison site - **Analyze market trends:** collect pricing and review data over time to understand which products are gaining popularity or losing traction - **Feed your analytics pipeline:** export structured data to Google Sheets, Airtable, Power BI, or any tool via Apify integrations Bol.com has **no public API for product data, no bulk export, and no price history feature**. This scraper is the only way to get structured product data out of the platform at scale. ### What data does Bol.com Scraper extract? 📦 **Product name** and full description 🏷️ **Brand** name 💰 **Price** and original price (discount detection) 💶 **Currency** — always EUR 📊 **Rating** (0-5) and review count 📦 **Stock status** — in stock or out of stock 🔢 **Product ID** and SKU 🖼️ **Images** — main image and all product photos 📋 **Specifications** — key-value pairs (screen size, memory, weight, etc.) 📂 **Category** — full breadcrumb path and category array 🏪 **Seller** — bol.com's own inventory vs. third-party marketplace sellers 🔗 **Direct URL** to the product on Bol.com ### How to scrape Bol.com products The input is simple: enter a **search keyword** or **category URLs** and hit run. You can configure the scraper through the Apify Console UI or programmatically via the API. #### Input parameters | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `searchQuery` | String | `"laptop"` | Search by keyword — e.g. `"Samsung Galaxy"`, `"LEGO"`, `"AirPods"` | | `categoryUrls` | Array | — | One or more Bol.com category page URLs to scrape directly | | `maxResults` | Integer | `100` | Maximum number of products to return (1 - 10,000) | | `proxyConfiguration` | Object | — | Proxy settings (recommended — Bol.com rate-limits aggressively) | #### Tips for best results - **Use proxies for any serious volume:** Bol.com rate-limits aggressively. Enable proxy configuration for reliable results beyond a handful of products. - **Combine search + categories:** use `searchQuery` for discovery and `categoryUrls` to scrape entire product categories systematically - **Start with a small `maxResults`** (e.g. 50) to verify output, then scale up to thousands - **Schedule daily runs** to track price changes over time — great for building price history datasets or alerting on discounts ### Output Results are stored in a **dataset** that you can download in JSON, CSV, Excel, XML, or HTML format directly from the Apify Console. #### JSON example ```json { "name": "Samsung Galaxy S24 Ultra 256GB Titanium Black", "brand": "Samsung", "price": 1299.00, "originalPrice": 1449.00, "currency": "EUR", "productId": "9300000155985953", "sku": "0887276789460", "inStock": true, "rating": 4.6, "reviewCount": 142, "imageUrl": "https://media.s-bol.com/images/products/samsung-galaxy-s24-ultra-256gb.jpg", "imageUrls": [ "https://media.s-bol.com/images/products/samsung-galaxy-s24-ultra-256gb-1.jpg", "https://media.s-bol.com/images/products/samsung-galaxy-s24-ultra-256gb-2.jpg", "https://media.s-bol.com/images/products/samsung-galaxy-s24-ultra-256gb-3.jpg" ], "description": "De Samsung Galaxy S24 Ultra is het vlaggenschip van Samsung met een 6.8 inch Dynamic AMOLED display, 200MP camera en ingebouwde S Pen...", "category": "Telefoons > Smartphones", "categories": ["Elektronica", "Telefoons", "Smartphones"], "specs": { "Beeldschermdiagonaal": "6.8 inch", "Intern geheugen": "256 GB", "Besturingssysteem": "Android 14", "Gewicht": "232 g" }, "seller": "bol", "url": "https://www.bol.com/nl/nl/p/samsung-galaxy-s24-ultra-256gb-titanium-black/9300000155985953/", "scrapedAt": "2026-04-04T14:00:00.000Z" } ```` ### How much does it cost to scrape Bol.com? Bol.com Scraper uses **only HTTP requests** (no browser), making it fast and affordable to run. | Scenario | Est. cost | Time | |----------|-----------|------| | 100 products | ~$0.15 | ~30 sec | | 1,000 products | ~$1.50 | ~3 min | | 10,000 products | ~$15.00 | ~25 min | **Pricing breakdown:** - Per run start: $0.01 - Per result: ~$0.0015 - Pay-per-event: $0.004/result ### Can I integrate Bol.com Scraper with other apps? Yes. Bol.com Scraper connects with any tool through [Apify integrations](https://apify.com/integrations): - **Google Sheets** — automatically export product data to a spreadsheet - **Slack / Email** — get notified when prices drop or products go out of stock - **Zapier / Make** — trigger workflows when data is ready - **Airtable** — build a searchable product database - **REST API** — call the scraper programmatically from any language - **Webhooks** — get notified when a run finishes ### Can I use Bol.com Scraper as an API? Yes. Use the [Apify API](https://docs.apify.com/api/v2) to run Bol.com Scraper programmatically. **Python:** ```python from apify_client import ApifyClient client = ApifyClient("YOUR_API_TOKEN") run = client.actor("studio-amba/bol-scraper").call(run_input={ "searchQuery": "Samsung Galaxy", "maxResults": 100, }) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(f"{item['name']} — EUR {item['price']}") ``` **JavaScript:** ```javascript import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: 'YOUR_API_TOKEN' }); const run = await client.actor('studio-amba/bol-scraper').call({ searchQuery: 'Samsung Galaxy', maxResults: 100, }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log(items); ``` Check the [API tab](https://apify.com/studio-amba/bol-scraper/api) for full documentation. ### FAQ #### What is Bol.com? Bol.com is the largest online retailer in the Netherlands and Belgium, with over 35 million products across electronics, books, toys, fashion, home, garden, and more. It operates both as a direct retailer and as a marketplace where third-party sellers list products — similar to Amazon in the Benelux region. #### How does Bol.com Scraper work? It parses Bol.com search results and product pages using HTTP requests, extracting structured data from JSON-LD and HTML. No browser automation is needed, which makes it fast, reliable, and cheap to run. #### Can I scrape specific product categories? Yes. Use the `categoryUrls` input to provide one or more Bol.com category page URLs. The scraper will extract all products from those category pages up to your `maxResults` limit. #### Can I detect price drops and discounts? Yes. The scraper returns both `price` (current selling price) and `originalPrice` (the strikethrough price shown on Bol.com). Compare these to identify discounted products. Schedule daily runs to build a price history over time. #### Can I tell if a product is sold by Bol.com or a marketplace seller? Yes. The `seller` field distinguishes between products sold by bol.com directly and those listed by third-party marketplace sellers. #### Does it work for both Netherlands and Belgium? Yes. Bol.com serves both the Dutch and Belgian markets from a single platform. The scraper uses the `/nl/nl/` path prefix, which covers all products available in both countries. #### Is it legal to scrape Bol.com? This scraper extracts publicly available product data that Bol.com displays to all visitors. The data is factual (prices, specs, availability) and does not contain private personal information. As with any scraping tool, use the data responsibly and in compliance with applicable laws. ### Limitations - **Netherlands and Belgium only.** Bol.com operates exclusively in the Benelux market. - **Proxies recommended.** Bol.com rate-limits aggressively — use proxy configuration for reliable results at scale. - **Sponsored products included.** Search results may contain promoted/sponsored listings, matching what Bol.com shows to visitors. - **Dutch product data.** Specs, descriptions, and categories are in Dutch as served by Bol.com. - **Concurrency capped at 3** to respect Bol.com's rate limits and ensure reliable extraction. ### Other Belgian e-commerce scrapers Combine Bol.com Scraper with these actors for comprehensive Benelux e-commerce coverage: - 🛒 [Coolblue Scraper](https://apify.com/studio-amba/coolblue-scraper) — Electronics and appliances from the Benelux's favorite electronics retailer - 🏪 [Action Scraper](https://apify.com/studio-amba/action-scraper) — Budget products from Europe's fastest-growing discount retailer - 💊 [Kruidvat Scraper](https://apify.com/studio-amba/kruidvat-scraper) — Health, beauty, and personal care products across Benelux - 🏃 [Decathlon Scraper](https://apify.com/studio-amba/decathlon-scraper) — Sports and outdoor gear from Belgium's top sports retailer ### Your feedback Found a bug or have a feature request? Please open an issue on the [Issues tab](https://apify.com/studio-amba/bol-scraper/issues). We actively maintain this scraper and respond to all reports. # Actor input Schema ## `searchQuery` (type: `string`): Search for products by name or keyword (e.g., 'laptop', 'Samsung Galaxy', 'stofzuiger') ## `categoryUrls` (type: `array`): Bol.com category pages to scrape. Example: https://www.bol.com/nl/nl/l/laptops/4770/ ## `maxResults` (type: `integer`): Maximum number of products to return. ## `proxyConfiguration` (type: `object`): Proxy settings. Recommended for large runs. ## Actor input object example ```json { "searchQuery": "laptop", "maxResults": 100 } ``` # Actor output Schema ## `results` (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 = { "searchQuery": "laptop" }; // Run the Actor and wait for it to finish const run = await client.actor("studio-amba/bol-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 = { "searchQuery": "laptop" } # Run the Actor and wait for it to finish run = client.actor("studio-amba/bol-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 '{ "searchQuery": "laptop" }' | apify call studio-amba/bol-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=studio-amba/bol-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Bol.com Scraper — Dutch & Belgian Products & Prices", "description": "Scrape products, prices, ratings, and availability from Bol.com — the #1 online retailer in the Netherlands and Belgium. Supports search queries and category browsing.", "version": "0.1", "x-build-id": "A0BlCMQoNauSo5rIV" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/studio-amba~bol-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-studio-amba-bol-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/studio-amba~bol-scraper/runs": { "post": { "operationId": "runs-sync-studio-amba-bol-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/studio-amba~bol-scraper/run-sync": { "post": { "operationId": "run-sync-studio-amba-bol-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": "Search for products by name or keyword (e.g., 'laptop', 'Samsung Galaxy', 'stofzuiger')" }, "categoryUrls": { "title": "Category URLs", "type": "array", "description": "Bol.com category pages to scrape. Example: https://www.bol.com/nl/nl/l/laptops/4770/", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxResults": { "title": "Max Results", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of products to return.", "default": 100 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings. Recommended for large runs." } } }, "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 } } } } } } } } } } ```