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

{
  "searchQuery": "Software"
}

Example Input - Direct KVK Lookup

{
  "kvkNumbers": ["82871612"]
}

Output

Handelsregister Record

{
  "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

.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