KVK Scraper An Apify Actor for scraping data from the Dutch Chamber of Commerce (Kamer van Koophandel / KVK) Handelsregister (Trade Register). ## Features - Search for companies by name, KVK number, or other identifiers - Direct KVK number lookup - Automatic pagination handling - Filters to only include official Handelsregister entries ## Input | Field | Type | Description | Default | |-------|------|-------------|---------| | searchQuery | string | Search query (company name, number, etc.) | - | | kvkNumbers | string[] | Direct KVK numbers to search (8 digits each) | [] | | maxPages | integer | Maximum pages to scrape (0 = unlimited) | 0 | | pageSize | integer | Results per page (max 100) | 20 | | maxConcurrency | integer | Maximum concurrent requests | 5 | ### Example Input - Search by Name json { "searchQuery": "Software" } ### Example Input - Direct KVK Lookup json { "kvkNumbers": ["82871612"] } ## Output ### Handelsregister Record json { "id": "e027319e-bddf-4982-ac35-ed5cd4a96222", "kvkNumber": "82871612", "establishmentNumber": "000049081160", "name": "Software Buddy", "legalFormCode": "EMZ", "legalForm": "Eenmanszaak", "isActive": true, "isEstablishment": true, "registrationType": "Hoofdvestiging", "visitingAddress": { "street": "Kloosterlaan", "houseNumber": "33", "postalCode": "1216NH", "city": "Hilversum" }, "postalAddress": { "street": null, "houseNumber": null, "postalCode": null, "city": null }, "activityDescription": "Ontwikkelen, produceren en uitgeven van software...", "currentTradeNames": ["Software Buddy", "Maxtrada", "SeyfaXL"], "formerTradeNames": ["Codemap NL"], "statutoryName": null, "source": "Actueel" } ## Project Structure text .actor/ ├── actor.json # Actor config ├── dataset_schema.json # Output data structure ├── input_schema.json # Input validation └── output_schema.json # Output specification src/ ├── main.ts # Actor entry point ├── routes/ │ └── handelsregister.ts # Handelsregister request handlers └── utils/ ├── handelsregister.ts # Handelsregister utilities and types └── headers.ts # API headers configuration storage/ # Local storage (development) ## Disclaimer This Actor is provided for educational and informational purposes only. By using this Actor, you agree to: - Comply with KVK's Terms of Service - Use the data responsibly and in accordance with applicable laws - Not overload the KVK servers with excessive requests - Respect rate limits and use appropriate delays for large scrapes The data retrieved from KVK is publicly available information. However, the developers of this Actor are not responsible for any misuse of the data or violations of KVK's terms of service. Use at your own risk. This Actor is not affiliated with or endorsed by KVK (Kamer van Koophandel). ## Resources - Apify Documentation - Crawlee Documentation - KVK Handelsregister