{ "openapi": "3.0.1", "info": { "title": "BOL.com Marketplace Seller Leads Scraper: Offers and Monitoring", "description": "Collect public BOL.com seller leads from category and product pages. Export shop names, seller IDs, offer prices, EANs, ratings, product context, and change events to Apify datasets, CSV, JSON, or API workflows. Start at $3.50 per 1,000 rows without browser automation or external email enrichment.", "version": "0.1", "x-build-id": "Hwgv4HX2cAirAyqh8" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getascraper~bol-com-seller-leads-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getascraper-bol-com-seller-leads-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~bol-com-seller-leads-scraper/runs": { "post": { "operationId": "runs-sync-getascraper-bol-com-seller-leads-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~bol-com-seller-leads-scraper/run-sync": { "post": { "operationId": "run-sync-getascraper-bol-com-seller-leads-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": { "startUrls": { "title": "Public category or product URLs", "maxItems": 20, "type": "array", "description": "Optional public BOL category (/l/), product (/p/), or sitemap URL(s). When supplied, these replace the default product category source. BOL search (/s/), seller (/v/), product-overview (/w/), price-overview, account, and API URLs are rejected because they are disallowed by BOL's public robots policy.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "store": { "title": "BOL storefront", "enum": [ "nl", "be", "both" ], "type": "string", "description": "Select the storefront used when the default category source is created. This does not override explicit Start URLs.", "default": "nl" }, "includeProductContext": { "title": "Include product and offer context", "type": "boolean", "description": "Add the product title, product ID, visible offer price, currency, and product URL from the allowed product page that exposed the seller. Seller rows are still emitted without this optional context.", "default": false }, "runMode": { "title": "Run mode", "enum": [ "snapshot", "changes" ], "type": "string", "description": "Snapshot emits every unique seller discovered in this run. Changes compares public source fields with persistent state and emits only new or updated sellers.", "default": "snapshot" }, "maxSellers": { "title": "Maximum seller leads", "minimum": 1, "maximum": 250, "type": "integer", "description": "Maximum number of unique seller rows to emit. The Actor stops adding new sellers after this cap.", "default": 5 }, "maxProductsPerSource": { "title": "Maximum products per source", "minimum": 1, "maximum": 50, "type": "integer", "description": "Maximum total product detail pages followed from each category or sitemap source. More product pages expose more seller offers but cost more requests.", "default": 10 }, "maxPages": { "title": "Maximum category pages", "minimum": 1, "maximum": 20, "type": "integer", "description": "Maximum category pagination pages followed for each category source. Sitemap sources and direct product URLs use one source page.", "default": 3 }, "requestDelayMs": { "title": "Delay between requests (ms)", "minimum": 500, "maximum": 5000, "type": "integer", "description": "Minimum delay between serialized HTTP requests. A delay of 1000 ms is the default for source courtesy and lower block risk.", "default": 1000 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Supported Apify proxy routing. The default UNBLOCKER group is used only for public BOL pages and does not solve CAPTCHAs or access robots-disallowed routes. Disable it only if your own network can fetch BOL successfully.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "UNBLOCKER" ] } } } }, "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 } } } } } } } } } }