{ "openapi": "3.0.1", "info": { "title": "KvK Handelsregister Scraper - Dutch Company Register", "description": "Search the Dutch KvK Handelsregister by company name, keyword or KvK number. Get KvK and establishment numbers, legal form, registration type and date, visiting and postal address, activities and current and former trade names.", "version": "1.0", "x-build-id": "HeSQnzfuE0a2UWcPT" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parsebird~kvk-handelsregister-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parsebird-kvk-handelsregister-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/parsebird~kvk-handelsregister-scraper/runs": { "post": { "operationId": "runs-sync-parsebird-kvk-handelsregister-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/parsebird~kvk-handelsregister-scraper/run-sync": { "post": { "operationId": "run-sync-parsebird-kvk-handelsregister-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 queries", "type": "array", "description": "Company names, trade names, keywords, places or postcodes, the same as you would type in the KvK search box. Each query runs its own search.", "items": { "type": "string" } }, "kvkNumbers": { "title": "KvK numbers", "type": "array", "description": "8-digit KvK numbers to look up directly. Each returns every registration for that number (legal entity, main branch, other branches) that matches the filters below.", "items": { "type": "string" } }, "maxItems": { "title": "Max records", "minimum": 0, "type": "integer", "description": "Total records to save across all queries and KvK numbers. 0 = no limit.", "default": 0 }, "maxPages": { "title": "Max pages per query", "minimum": 0, "type": "integer", "description": "Result pages to read per query. 0 = all pages (KvK serves at most the first 5,000 results of a search).", "default": 0 }, "pageSize": { "title": "Results per page", "minimum": 1, "maximum": 50, "type": "integer", "description": "Results per request, 1-50 (KvK's maximum). Larger pages mean fewer KvK search page charges for the same data.", "default": 50 }, "site": { "title": "Result source", "enum": [ "handelsregister", "kvk2014", "corporate" ], "type": "string", "description": "`handelsregister` = company register only. `kvk2014` = everything kvk.nl search returns: register entries plus KvK's Advies & Inspiratie articles. `corporate` = Advies & Inspiratie articles only.", "default": "handelsregister" }, "inschrijvingsstatus": { "title": "Registration status", "type": "array", "description": "Registered (active) and/or deregistered companies. Leave empty for both.", "items": { "type": "string", "enum": [ "ingeschreven", "uitgeschreven" ], "enumTitles": [ "Registered (ingeschreven)", "Deregistered (uitgeschreven)" ] }, "default": [ "ingeschreven" ] }, "vestigingType": { "title": "Registration type", "type": "array", "description": "Main branches, other branches, legal entities and/or other registrations. Leave empty for all.", "items": { "type": "string", "enum": [ "hoofdvestigingen", "nevenvestigingen", "rechtspersonen", "overig" ], "enumTitles": [ "Main branches (hoofdvestigingen)", "Branches (nevenvestigingen)", "Legal entities (rechtspersonen)", "Other registrations (overig)" ] }, "default": [] }, "handelsnamen": { "title": "Trade names", "type": "array", "description": "Match on current and/or former (expired) trade names. Leave empty for both.", "items": { "type": "string", "enum": [ "bestaandeHandelsnamen", "vervallenHandelsnamen" ], "enumTitles": [ "Current trade names", "Former (expired) trade names" ] }, "default": [] }, "language": { "title": "Language", "enum": [ "nl", "en" ], "type": "string", "description": "Search language. Mainly affects Advies & Inspiratie articles; register data is the same.", "default": "nl" }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 5, "type": "integer", "description": "Queries searched in parallel (1-5).", "default": 5 }, "maxRequestsPerMinute": { "title": "Max requests per minute", "minimum": 1, "maximum": 600, "type": "integer", "description": "Upper limit on requests to KvK per minute. Lower it if you see rate-limit errors without a proxy.", "default": 120 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Not needed for most runs. Enabling Apify Proxy adds a one-time proxy charge per run (see Pricing): datacenter without a group, residential with a proxy group.", "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 }, "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 } } } } } } } } } }