# KVK Handelsregister Scraper — Dutch Chamber of Commerce Lookup (`studio-amba/kvk-scraper`) Actor

Look up any Dutch company in the KVK Handelsregister (Chamber of Commerce): confirm it's registered and active before you sign a contract, extend credit, or wire a payment. Search by name, KVK number, city, or postal code and get the registered name, address, legal form, trade names, and status.

- **URL**: https://apify.com/studio-amba/kvk-scraper.md
- **Developed by:** [Studio Amba](https://apify.com/studio-amba) (community)
- **Categories:** Lead generation
- **Stats:** 24 total users, 3 monthly users, 80.4% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $12.00 / 1,000 result scrapeds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## KVK Handelsregister Scraper — Dutch Chamber of Commerce Lookup

Look up any Dutch company in the KVK Handelsregister, the trade register kept by the Kamer van Koophandel (Chamber of Commerce). Confirm a company is real, registered, and still active before you sign a contract, extend credit, or wire a payment. Search by company name, KVK number, city, or postal code and get back the registered name, KVK number, address, trade names, legal form, SBI activity codes, and registration status. No cookies, no login required.

### How to scrape KVK company data

This actor searches the official Dutch Kamer van Koophandel register and extracts structured company data. The KVK register contains every Dutch company, sole trader, foundation, and association — over 2.5 million active entities.

#### Search by Company Name

Enter a company name or keyword. The actor searches the KVK register and returns all matching companies with their registration details, addresses, and activity codes.

#### Search by KVK Number

Look up a specific company by its 8-digit KVK number for an exact match. Every Dutch company has a unique KVK number assigned at registration.

#### Filter by Location

Narrow results by city name or postal code to focus on a specific geographic area. Useful for local market research, mapping competitors, or building regional lead lists.

### What data does Dutch Company Register Scraper extract?

| Field | Type | Description |
|-------|------|-------------|
| **companyName** | String | Official registered company name |
| **kvkNumber** | String | 8-digit KVK registration number |
| **branchNumber** | String | 12-digit branch establishment number (vestigingsnummer) |
| **rsin** | String | Not available — KVK only shows this on a paid extract, always empty |
| **legalForm** | String | Legal form (Besloten Vennootschap, Eenmanszaak, etc.) |
| **registrationStatus** | String | Active or deregistered |
| **tradeNames** | Array | Current trade names (handelsnamen) |
| **formerTradeNames** | Array | Not available — KVK only shows this on a paid extract, always empty |
| **address** | String | Full visiting address |
| **street** | String | Street name, parsed from the address |
| **houseNumber** | String | House number, parsed from the address |
| **postalCode** | String | Dutch postal code (1234AB format) |
| **city** | String | City name |
| **province** | String | Not available — KVK only shows this on a paid extract, always empty |
| **sbiActivities** | Array | Free-text primary activity description KVK shows on the search card. The numeric SBI code needs KVK's paid extract, so `code` is always empty here — only `description` is populated. |
| **employeeCount** | String | Not available — KVK only shows this on a paid extract, always empty |
| **establishmentType** | String | Hoofdvestiging (main) or Nevenvestiging (branch) |
| **registrationDate** | String | Not available — KVK only shows this on a paid extract, always empty |
| **url** | String | Link to the company's KVK order page |
| **scrapedAt** | String | ISO timestamp of extraction |

### Input Parameters

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| **Company Name / Keywords** | String | — | Search by company name or keywords |
| **KVK Number** | String | — | Look up by 8-digit KVK number |
| **City** | String | — | Filter by city name |
| **Postal Code** | String | — | Filter by postal code |
| **Active Companies Only** | Boolean | `true` | Skip deregistered companies |
| **Max Results** | Integer | `100` | Maximum companies to return |
| **Proxy Configuration** | Object | Residential | Proxy settings |

### Example output

```json
{
    "companyName": "Philips & Philips B.V.",
    "kvkNumber": "90428587",
    "branchNumber": "000056159579",
    "rsin": "",
    "legalForm": "Besloten Vennootschap",
    "registrationStatus": "active",
    "tradeNames": ["Philips & Philips B.V."],
    "formerTradeNames": [],
    "address": "Van Hengellaan 2, 1217AS Hilversum",
    "street": "Van Hengellaan",
    "houseNumber": "2",
    "postalCode": "1217AS",
    "city": "Hilversum",
    "province": "",
    "sbiActivities": [
        { "code": "", "description": "Het uitoefenen van de rechtspraktijk als advocaat." }
    ],
    "employeeCount": "",
    "establishmentType": "Hoofdvestiging",
    "registrationDate": "",
    "url": "https://www.kvk.nl/bestellen/#/90428587000056159579?origin=search",
    "scrapedAt": "2026-08-29T07:51:13.589Z"
}
```

Fields left empty above (`rsin`, `formerTradeNames`, `province`, `employeeCount`, `registrationDate`, and the numeric part of `sbiActivities`) are not shown on KVK's free search page — KVK only releases them through its paid extract product.

### Tips for best results

- **B2B lead generation**: Search by city + industry keyword to build targeted lead lists. Example: "accountant" in "Rotterdam".
- **Due diligence**: Look up specific KVK numbers to verify company existence and registration status.
- **Competitor mapping**: Search by product or service keyword to find all competitors in a region.
- **Active filter**: Keep "Active Companies Only" enabled to exclude dissolved and deregistered entities.
- **Rate limiting**: The KVK site has modest rate limits. For large runs (1000+ results), use proxy configuration.

### How much does it cost?

Dutch Company Register Scraper charges $0.04 per run (start fee, based on its 4 GB memory allocation) plus $0.012 per result. 10 companies costs about $0.16; 100 about $1.24; 1,000 about $12.04. A run's usage cost only settles after it reports SUCCEEDED.

### Can I integrate?

Yes. Send Dutch company data directly to your existing tools:

- **Google Sheets** — Build a live Dutch company database
- **HubSpot / Salesforce** — Enrich CRM contacts with official KVK data
- **Slack** — Get notified about new companies matching your criteria
- **Webhooks** — Push to any HTTP endpoint for custom workflows

### Can I use it as an API?

Yes. Call Dutch Company Register Scraper programmatically:

#### Python

```python
from apify_client import ApifyClient

client = ApifyClient("YOUR_API_TOKEN")

run = client.actor("studio-amba/kvk-scraper").call(run_input={
    "searchQuery": "Philips",
    "city": "Amsterdam",
    "maxResults": 20,
})

for company in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(f"{company['companyName']} (KVK {company['kvkNumber']}) — {company['city']}")
```

#### JavaScript

```javascript
import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_API_TOKEN' });

const run = await client.actor('studio-amba/kvk-scraper').call({
    searchQuery: 'IT',
    city: 'Utrecht',
    maxResults: 50,
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach(c => console.log(`${c.companyName} | KVK ${c.kvkNumber} | ${c.city}`));
```

### FAQ

#### What is the KVK?

The KVK (Kamer van Koophandel) is the Netherlands' official commercial register. Every Dutch business entity — companies, sole traders, foundations, associations — must register with the KVK and receives a unique 8-digit KVK number.

#### What is a KVK number?

A KVK number is a unique 8-digit identifier assigned to every entity in the Dutch commercial register. It's used for business identification, tax, and legal purposes.

#### What are SBI codes?

SBI (Standaard Bedrijfsindeling) codes classify companies by economic activity, similar to NACE codes in Europe. Each company has one or more SBI codes describing what they do.

#### How to verify a Dutch company?

Enter the KVK number in this actor to verify a company's registration status, legal form, and address. Active companies are currently registered; deregistered companies have been dissolved.

#### What's the difference between KVK number and vestigingsnummer?

The KVK number identifies the legal entity. The vestigingsnummer (12 digits) identifies a specific establishment/branch location. A company with 5 offices has 1 KVK number and 5 vestigingsnummers.

### Limitations

- Detailed company profiles (numeric SBI codes, RSIN, employee counts, registration date, annual reports) require the paid KVK API — this actor extracts what's publicly available on the search interface, including the free-text activity description and trade name(s)
- The KVK site rate-limits at roughly 60-120 requests/minute
- Maximum 50 results per search page on kvk.nl — broad queries need multiple pages
- Some company data (e.g., financial statements) is only available via paid KVK products

### Other European company register scrapers

Working with European business data? Combine with these tools:

- **[EU Dealer Counterparty Check](https://apify.com/studio-amba/eu-dealer-counterparty-check)** — runs this scraper alongside 14 other European registries and merges the results into one counterparty dossier with risk flags
- **[Belgian Company Enrichment](https://apify.com/studio-amba/kbo-enrichment)** — Belgian KBO/BCE company register
- **[German Company Register](https://apify.com/studio-amba/handelsregister-scraper)** — German Handelsregister
- **[French Company Enrichment](https://apify.com/studio-amba/french-company-enrichment)** — French company data from official sources

### Your feedback

Found a bug or want a feature? Open an issue on the [Issues tab](https://console.apify.com/actors/studio-amba~kvk-scraper/issues). Your feedback helps improve this actor.

# Actor input Schema

## `searchQuery` (type: `string`):

Search for companies by name or keywords. Example: 'Philips', 'Shell', 'Booking'.

## `kvkNumber` (type: `string`):

Look up a specific company by its 8-digit KVK number.

## `city` (type: `string`):

Filter by city. Example: 'Amsterdam', 'Rotterdam', 'Utrecht'.

## `postalCode` (type: `string`):

Filter by postal code. Example: '1012AB'.

## `activeOnly` (type: `boolean`):

Only return currently registered (active) companies.

## `maxResults` (type: `integer`):

Maximum number of companies to return.

## `proxyConfiguration` (type: `object`):

Apify proxy configuration. Datacenter proxies work fine for KVK.

## Actor input object example

```json
{
  "searchQuery": "Philips",
  "activeOnly": true,
  "maxResults": 20,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "NL"
  }
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "searchQuery": "Philips",
    "maxResults": 20,
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ],
        "apifyProxyCountry": "NL"
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("studio-amba/kvk-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "searchQuery": "Philips",
    "maxResults": 20,
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
        "apifyProxyCountry": "NL",
    },
}

# Run the Actor and wait for it to finish
run = client.actor("studio-amba/kvk-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "searchQuery": "Philips",
  "maxResults": 20,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "NL"
  }
}' |
apify call studio-amba/kvk-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,studio-amba/kvk-scraper"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/hH3Yn4565ZzrSj3Vt/builds/EnuOpRQyX7PCTJE5k/openapi.json
