{
  "openapi": "3.0.1",
  "info": {
    "title": "KVK Scraper | Dutch Companies and SBI Codes",
    "description": "KVK scraper for the Dutch Kamer van Koophandel Handelsregister. Search by company name, keyword, KVK number or kvk.nl link and get legal form, trade names, SBI activity codes, address, registration date and status. 100 companies in 1 second, 24 fields each. No login and no KvK API key needed.",
    "version": "1.0",
    "x-build-id": "LPbV5Lj2SwBnzwIQA"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/silentflow~kvk-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-silentflow-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/silentflow~kvk-scraper/runs": {
      "post": {
        "operationId": "runs-sync-silentflow-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/silentflow~kvk-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-silentflow-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": {
          "searches": {
            "title": "🔎 Company names or keywords",
            "type": "array",
            "description": "What you would type in the kvk.nl search box: a company name, a trade name, a keyword, a street or a postcode. Examples: <code>bakkerij</code>, <code>Philips</code>, <code>installatiebedrijf Rotterdam</code>, <code>5504BC</code>.<br><br>Each term is its own search. A broad keyword matches thousands of records; one search reads up to 5,000 of them, so add a city to go further. A KVK number or a kvk.nl link typed here is read as a lookup.",
            "items": {
              "type": "string"
            }
          },
          "companyIds": {
            "title": "🔢 KVK or branch numbers",
            "type": "array",
            "description": "Look companies up by number. An 8-digit <b>KVK number</b> returns every record of that company: the legal entity and all its branches. A 12-digit <b>branch number</b> (vestigingsnummer) returns that one location.<br><br>Spaces, dots and a KVK label are fine: <code>17001907</code>, <code>KvK 1700 1907</code>, <code>000010258434</code>. A KVK number that lost its leading zero in a spreadsheet (<code>6021609</code>) is read as <code>06021609</code>. Lookups return active and deregistered records alike.",
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "🔗 kvk.nl URLs",
            "type": "array",
            "description": "Paste kvk.nl links: a search page (<code>https://www.kvk.nl/zoeken/?q=bakkerij</code>, older <code>?handelsnaam=…&plaats=…</code> links work too) runs that search, a company page (<code>https://www.kvk.nl/bestellen/#/17001907000010258418</code>) reads that record.",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "city": {
            "title": "📍 City",
            "type": "string",
            "description": "Keep only companies whose visiting address is in this city, for every search term and search URL. Examples: <code>Utrecht</code>, <code>Den Haag</code> (matches 's-Gravenhage), <code>Eindhoven</code>.<br><br>The city is also added to the search, so a keyword plus a city reaches local companies past the 5,000-record limit of one search. Legal-entity records carry no address and are left out when a city is set. Number lookups ignore it."
          },
          "maxItems": {
            "title": "🔢 Max results per search",
            "minimum": 1,
            "type": "integer",
            "description": "The most rows each search term, search URL or KVK number returns. A KVK number of a chain can hold hundreds of branches. One search reads at most 5,000 records. Set it to what you need: the run stops as soon as it is reached.",
            "default": 100
          },
          "registrationStatus": {
            "title": "📋 Registration status",
            "enum": [
              "active",
              "deregistered",
              "all"
            ],
            "type": "string",
            "description": "<b>Active</b> returns companies registered today, as kvk.nl does by default. <b>Deregistered</b> returns closed ones (useful to check a former supplier). <b>All</b> returns both; the <code>isActive</code> column tells them apart.",
            "default": "active"
          },
          "registrationTypes": {
            "title": "🏢 Record types",
            "type": "array",
            "description": "Leave empty for every record. <b>Main branches</b> give one row per company with its address and SBI codes, the usual choice for a lead list. <b>Legal entities</b> are the BV, NV or foundation records, with their statutory name but no address.",
            "items": {
              "type": "string",
              "enum": [
                "hoofdvestigingen",
                "nevenvestigingen",
                "rechtspersonen",
                "overig"
              ],
              "enumTitles": [
                "Main branches (hoofdvestiging)",
                "Other branches (nevenvestiging)",
                "Legal entities (rechtspersoon)",
                "Other records (overig)"
              ]
            },
            "default": []
          },
          "sbiCodes": {
            "title": "🏷️ SBI activity codes",
            "type": "array",
            "description": "Keep only companies with an SBI code that starts with one of these digits. Examples: <code>1071</code> bakeries, <code>6920</code> accountants, <code>62</code> IT services, <code>4321</code> electricians.<br><br>Applies to search terms and search URLs: search <code>bakkerij</code> with <code>1071</code> and you drop the shops and foundations that only carry the word in their name.",
            "items": {
              "type": "string"
            }
          },
          "debugMode": {
            "title": "🐞 Debug mode",
            "type": "boolean",
            "description": "Write detailed logs. Leave off for normal runs.",
            "default": 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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}