# Belgium KBO Company Scraper — Directors, VAT & NACE Codes (`neuralverge/neuralverge-kbo-company`) Actor Scrape any Belgian company from the KBO/BCE register by enterprise number — name, legal form, status, address, start date, functions (directors), characteristics, VAT & NSSO NACE-BEL codes and external links. No API key. Structured JSON for KYB. Pay only for matches. - **URL**: https://apify.com/neuralverge/neuralverge-kbo-company.md - **Developed by:** [NeuralVerge](https://apify.com/neuralverge) (community) - **Categories:** Lead generation, Automation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $5.00 / 1,000 results 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/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use 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 ### Belgium KBO Company Scraper — Directors, VAT & NACE Codes Scrape any **Belgian company** from the official **KBO/BCE** register (Crossroads Bank for Enterprises / Kruispuntbank van Ondernemingen / Banque-Carrefour des Entreprises) by enterprise number — enterprise name, KBO number, legal form, status, registered address, start date, functions (directors / founders), characteristics (VAT, employer, registration status), VAT and NSSO NACE-BEL activity codes, and official external links. Powered by the Neuralverge API. **No API key, login or registration required**, and **you only pay for companies we actually find**. Structured JSON — export to CSV, JSON or Excel. Ideal for **KYB / company verification, due diligence, KYC/AML, merchant and vendor onboarding, Belgian lead generation** and feeding official registry data to AI agents. ### ✨ Why this Actor - 💸 **Pay only for the companies you get** — unresolved numbers are skipped and never billed. Misses are free. - 🔓 **No API key, no registration** — the Belgian KBO register, structured for you. - 🏛️ **Official source, full profile in one row** — identity, functions, characteristics, VAT/NSSO NACE codes and external links, flattened into spreadsheet-ready columns and kept in full as structured JSON. - ⚡ **Real-time & AI-structured** — fresh data each run and one predictable schema. ### 🔧 How it works 1. **Provide a Belgian enterprise number** (ondernemingsnummer), e.g. `725609983` (with or without dots). 2. **Run the Actor.** Fetching and AI-structuring the profile happen on the Neuralverge backend. 3. **Get one dataset row per company.** Export to CSV, JSON or Excel, or pull it over the Apify API. If the company can't be resolved, it's logged and **skipped without charge**. ### Input One company per run. | Field | Type | Notes | |---|---|---| | `companyNumber` | string | The enterprise number, e.g. `725609983` (dots are stripped). | | `companyUrl` | string | Optional. A full KBO public-search URL, used instead of the number. | | `countryCode` | string | Geo-routing code (advanced, default `us`). | ```json { "companyNumber": "725609983" } ```` ### What you'll receive Each row includes, when available on the profile: - **Identity** — `enterprise_name`, `kbo_number`, `legal_form`, `status`, `address`, `start_date` - **People** — `functions` (name, role, start date) with `functionsCount` - **Classification** — `characteristics` (+ flat `characteristicsText`), `vat_activities` and `nsso_activities` (NACE-BEL codes, + flat `vatActivitiesText`), `entrepreneurial_skills`, `authorisations` - **More** — `financial_information`, `entity_links`, `external_links` - **Meta** — `query`, `companyNumber`, `scrapedAt`, the markdown summary under `human`, and the complete response under `raw` #### Example output (real run) Real, unabridged response from a live run of **AVO BMW (0725.609.983)** (5 points, ~21s): ```json { "session_id": "7c12dd1a-19de-47b5-9355-1439075640bb", "kind": "extract", "url": "https://kbopub.economie.fgov.be/kbopub/toonondernemingps.html?lang=en&ondernemingsnummer=725609983", "used_url": "https://kbopub.economie.fgov.be/kbopub/toonondernemingps.html?lang=en&ondernemingsnummer=725609983", "instructions": "Extract data from KBO profile\n- In general\n- Functions\n- Entrepreneurial skill\n- Characteristics\n- Authorisations\n- Version of the Nacebel codes for the VAT activities\n- Version of the Nacebel codes for the NSSO activities\n- Financial information\n- Links between entities\n- External links", "settings": { "has_schema": true, "country_code": "us", "extract_schema_json": "{ … the KBO schema shown under `src/schema.js` … }" }, "human": "# KBO Profile Data\n\n## In general\n\n| Field | Value |\n|---|---|\n| Enterprise number | 0725.609.983 |\n| Status | **Active** |\n| Legal situation | **Normal situation** Since April 24, 2019 |\n| Start date | April 24, 2019 |\n| Name | AVO BMW Name in Dutch |\n| Registered seat's address | Rue des Cotillages 47 4500 Huy |\n| Entity type | Legal person |\n| Legal form | Private limited company Since December 8, 2023 |\n| Number of establishment units (EU) | **1** |\n\n## Functions\n\n| Name | Role | Start Date |\n|---|---|---|\n| Kostanyan , Avetik | Director | December 8, 2023 |\n\n## Characteristics\n\n* Employer National Social Security Office Since June 1, 2019\n* Subject to VAT Since June 1, 2019\n* Enterprise subject to registration Since June 6, 2019\n\n## Version of the Nacebel codes for the VAT activities\n\n### NACE-BEL codes 2025\n\n| Code | Description |\n|---|---|\n| 95.314 | Bodywork repair (including painting) Since January 1, 2025 |\n| 47.811 | Retail sale of cars and light motor vehicles (<= 3,5 tons) Since January 1, 2025 |", "machine": { "general_information": { "kbo_number": "0725.609.983", "enterprise_name": "AVO BMW", "legal_form": "Private limited company", "address": "Rue des Cotillages 47 4500 Huy", "status": "Active", "start_date": "2019-04-24" }, "functions": [ { "name": "Kostanyan , Avetik", "role": "Director", "start_date": "2023-12-08" } ], "entrepreneurial_skills": [], "characteristics": [ "Employer National Social Security Office", "Subject to VAT", "Enterprise subject to registration" ], "authorisations": [], "vat_activities": { "nacebel_version": "2025", "activities": [ { "code": "95.314", "description": "Bodywork repair (including painting)" }, { "code": "47.811", "description": "Retail sale of cars and light motor vehicles (<= 3,5 tons)" } ] }, "nsso_activities": { "nacebel_version": "2025", "activities": [ { "code": "95.311", "description": "General repair and maintenance of cars and light motor vehicles (<= 3,5 tons)" } ] }, "financial_information": { "last_filing_date": null }, "entity_links": [], "external_links": [ { "link_description": "Publications in National Gazette", "url": "https://www.ejustice.just.fgov.be/cgi_tsv/list.pl?language=fr&btw=0725609983&page=1&view_numac=0725609983" }, { "link_description": "Publication of the annual accounts in the Central Balance Sheet Office", "url": "https://consult.cbso.nbb.be/consult-enterprise/0725609983" }, { "link_description": "Database of statutes and powers of representation (notarial deeds)", "url": "https://statuts.notaire.be/stapor_v1/enterprise/0725609983/statutes" }, { "link_description": "Employers' repertory", "url": "https://employer-identification-consult.socialsecurity.be/employer/enterprise/0725609983" }, { "link_description": "Check withholding obligation", "url": "https://www.checkobligationderetenue.be" }, { "link_description": "Central Register of Director Disqualifications - log in", "url": "https://justban.just.fgov.be/en" } ] }, "total_points": 5, "duration_ms": 21404 } ``` > The Actor flattens the identity fields (`enterprise_name`, `kbo_number`, `legal_form`, > `status`, `address`, `start_date`) to the top level, adds `functionsCount`, > `characteristicsText` and `vatActivitiesText`, and keeps every section plus the full > `human` and `raw` response. ### Pricing Pay per result — **$0.005 per company** ($5 per 1,000) returned to the dataset. **You pay only for companies returned — misses are free.** | Event | Price | |---|---| | Actor start | Free | | Company returned (per dataset row) | **$0.005** | Enterprise numbers that can't be resolved are **not billed**. Pricing is on top of your Apify platform usage. ### Integrations & API Results are stored in a standard Apify dataset — export as CSV, JSON, XML or Excel, or fetch on demand through the [Apify API](https://docs.apify.com/api). The Actor also plugs into Apify's integrations (Make, Zapier, n8n, webhooks) and can be called from any [MCP](https://mcp.apify.com/) client to give an AI agent live Belgian company-registry data for KYB and verification. ### FAQ **Do I need a KBO account or API key?** No. Fetching and structuring run on the Neuralverge backend — you never provide credentials or keys. **Am I charged if a company isn't found?** No. You're billed only for rows returned to the dataset. **What identifier do I use?** The Belgian enterprise number (ondernemingsnummer), e.g. `725609983` — dots are optional. **Is the data official?** Yes — it comes from the KBO/BCE public register maintained by the Belgian FPS Economy. **How fresh is the data?** Each run fetches the profile at run time. *** **Disclaimer:** This Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by KBO/BCE, the Belgian FPS Economy, or the Belgian government. All trademarks are property of their respective owners. Data is sourced from the public register; use it in compliance with the register's terms and applicable data-protection law. # Actor input Schema ## `companyNumber` (type: `string`): The Belgian enterprise number (ondernemingsnummer) to look up, e.g. 725609983 (with or without dots). ## `companyUrl` (type: `string`): Optional. A full KBO public-search URL to use instead of the enterprise number. ## Actor input object example ```json { "companyNumber": "725609983" } ``` # Actor output Schema ## `results` (type: `string`): Structured KBO/BCE company data (identity, functions, characteristics, NACE codes, external links), one row per matched company. # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "companyNumber": "725609983" }; // Run the Actor and wait for it to finish const run = await client.actor("neuralverge/neuralverge-kbo-company").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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "companyNumber": "725609983" } # Run the Actor and wait for it to finish run = client.actor("neuralverge/neuralverge-kbo-company").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "companyNumber": "725609983" }' | apify call neuralverge/neuralverge-kbo-company --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=neuralverge/neuralverge-kbo-company", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Belgium KBO Company Scraper — Directors, VAT & NACE Codes", "description": "Scrape any Belgian company from the KBO/BCE register by enterprise number — name, legal form, status, address, start date, functions (directors), characteristics, VAT & NSSO NACE-BEL codes and external links. No API key. Structured JSON for KYB. Pay only for matches.", "version": "0.1", "x-build-id": "4z8pXtnwf23bLJIKj" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/neuralverge~neuralverge-kbo-company/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-neuralverge-neuralverge-kbo-company", "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/neuralverge~neuralverge-kbo-company/runs": { "post": { "operationId": "runs-sync-neuralverge-neuralverge-kbo-company", "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/neuralverge~neuralverge-kbo-company/run-sync": { "post": { "operationId": "run-sync-neuralverge-neuralverge-kbo-company", "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": { "companyNumber": { "title": "Enterprise number (KBO/BCE)", "type": "string", "description": "The Belgian enterprise number (ondernemingsnummer) to look up, e.g. 725609983 (with or without dots)." }, "companyUrl": { "title": "Company profile URL (advanced)", "type": "string", "description": "Optional. A full KBO public-search URL to use instead of the enterprise number." } } }, "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 } } }, "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 } } } } } } } } } } ```