{ "openapi": "3.0.1", "info": { "title": "KVK Scraper - Dutch Company Register (Handelsregister)", "description": "Search the Dutch KVK Handelsregister by name, keyword, city or KVK number: KVK and establishment numbers, legal form, trade and former names, registration date, activity, visit and postal address, active status. No login, no API key. Error rows are free.", "version": "0.1", "x-build-id": "WPIyLXzpUckRtkezW" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapewise~kvk-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapewise-kvk-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/scrapewise~kvk-scraper/runs": { "post": { "operationId": "runs-sync-scrapewise-kvk-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/scrapewise~kvk-scraper/run-sync": { "post": { "operationId": "run-sync-scrapewise-kvk-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": { "searchQueries": { "title": "Search keywords or company names", "type": "array", "description": "Company names, trade names or keywords, one per line, as you would type them in the kvk.nl search box (for example software Amsterdam, Coolblue or bakkerij). Each line is one search.", "items": { "type": "string" } }, "kvkNumbers": { "title": "KVK numbers", "type": "array", "description": "8-digit KVK numbers to look up, one per line. Each number returns its main establishment, branches and legal entity record.", "items": { "type": "string" } }, "location": { "title": "City", "type": "string", "description": "Keep only records whose visit or postal address is in this city, for example Rotterdam or Utrecht. Empty = the whole country." }, "legalForms": { "title": "Legal form", "type": "array", "description": "Keep only these legal forms. Empty = all.", "items": { "type": "string", "enum": [ "BV", "NV", "EMZ", "VOF", "CV", "MTS", "ST", "VER", "COOP", "OWM", "BRV" ], "enumTitles": [ "BV (private limited company)", "NV (public limited company)", "Eenmanszaak (sole proprietorship)", "VOF (general partnership)", "CV (limited partnership)", "Maatschap (professional partnership)", "Stichting (foundation)", "Vereniging (association)", "Cooperatie (cooperative)", "OWM (mutual insurance)", "Foreign legal form" ] } }, "mainEstablishmentOnly": { "title": "Main establishments only", "type": "boolean", "description": "On: only the head office (hoofdvestiging) of each company, without branches and separate legal entity records.", "default": false }, "includeInactive": { "title": "Include deregistered companies", "type": "boolean", "description": "On: also returns records that are no longer registered (isActive false), including legacy records.", "default": false }, "startUrls": { "title": "kvk.nl search links", "type": "array", "description": "Optional: links copied from the kvk.nl search (https://www.kvk.nl/zoeken/?q=...). The search text in the link is used.", "items": { "type": "string" } }, "maxItems": { "title": "Max records", "minimum": 0, "type": "integer", "description": "Hard cap for the whole run, across all searches. 0 = no cap (kvk.nl shows up to about 5,000 records per search).", "default": 50 }, "onlyNew": { "title": "Only new records (for schedules)", "type": "boolean", "description": "On: remembers the records delivered in earlier runs of the same search (in your account) and delivers only records not seen before. Skipped records are free.", "default": false }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify Proxy by default. Change it only if you know you need to.", "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 } } } } } } } } } }