# Belgian Company Enrichment — KBO/BCE Lookup, No Login Required (`studio-amba/kbo-enrichment`) Actor Enrich Belgian company data from the official KBO/BCE database. Look up any enterprise by number, name, or address. Returns legal form, NACE activities, capital, management, address, and more. No cookies, no login. - **URL**: https://apify.com/studio-amba/kbo-enrichment.md - **Developed by:** [Studio Amba](https://apify.com/studio-amba) (community) - **Categories:** Business, Lead generation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## 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.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.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/platform/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 ## Belgian Company Enrichment — KBO/BCE Lookup Enrich Belgian company data from the official Kruispuntbank van Ondernemingen (KBO/BCE) database. Look up any enterprise by number, name, or address. Returns legal form, NACE activity codes, capital, management, address, VAT status, and more. No cookies, no login required. ### How to scrape Belgian company data This actor provides three search modes for accessing official Belgian company data: #### Mode 1: Enterprise Number Lookup (fastest) Paste one or more KBO/BTW enterprise numbers. The actor fetches the official company page and extracts all available data. Accepts multiple formats: `0417.497.106`, `0417497106`, or `BE0417497106`. Use this for B2B lead enrichment — feed a list of enterprise numbers from your CRM and get back full company profiles. #### Mode 2: Name Search Search by company name (or part of a name). The actor searches the KBO database, collects all matching enterprise numbers, then enriches each result. Useful for finding competitors, verifying company identity, or prospecting by name. #### Mode 3: Address Search Find all companies registered at a specific address. Search by postal code, street name, and house number. Useful for mapping business density in an area, or checking who else is registered at a shared office address. ### What data does Belgian Company Enrichment extract? | Field | Type | Description | |-------|------|-------------| | **enterpriseNumber** | String | Official KBO number (format: 0417.497.106) | | **name** | String | Current registered company name | | **abbreviation** | String | Company abbreviation if registered | | **legalForm** | String | Legal form (NV, BV, VZW, CV, VOF, etc.) | | **entityType** | String | Entity type (Rechtspersoon, Natuurlijk persoon) | | **status** | String | Active or stopped | | **legalCondition** | String | Legal condition with date (Normale toestand, Gerechtelijk akkoord, etc.) | | **startDate** | String | Date the company was registered | | **address** | String | Full registered address | | **street** | String | Street name | | **houseNumber** | String | House number | | **postalCode** | String | Belgian postal code | | **city** | String | City name | | **phone** | String | Phone number (if registered in KBO) | | **email** | String | Email address (if registered in KBO) | | **website** | String | Website URL (if registered in KBO) | | **naceActivities** | Array | NACE-BEL activity codes with descriptions | | **capital** | String | Registered capital amount | | **numberOfEstablishments** | Integer | Number of branch establishments | | **annualMeetingMonth** | String | Month of annual general meeting | | **fiscalYearEnd** | String | End date of fiscal year | | **vatRegistered** | Boolean | Whether VAT-registered | | **vatSince** | String | VAT registration date | | **employerRegistered** | Boolean | Whether registered as employer (RSZ) | | **employerSince** | String | Employer registration date | | **management** | Array | Board members with function and appointment date | | **establishments** | Array | Branch unit details (if "Include Establishments" is enabled) | | **qualifications** | Array | Official qualifications and registrations | | **previousEnterpriseNumbers** | Array | Previous KBO numbers (from mergers, restructuring) | | **url** | String | Direct link to the KBO Public Search page | | **scrapedAt** | String | ISO timestamp of extraction | ### Input Parameters | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | **Search Mode** | Select | `number` | Choose: Number Lookup, Name Search, or Address Search | | **Enterprise Numbers** | String List | — | One or more KBO/BTW numbers | | **Company Name** | String | — | Company name to search (name mode) | | **Postal Code** | String | — | Postal code filter (name + address mode) | | **Street Name** | String | — | Street name (address mode) | | **House Number** | String | — | House number (address mode) | | **Include Establishments** | Boolean | `false` | Also scrape branch establishment data | | **Include Management** | Boolean | `true` | Also extract board members and positions | | **Active Companies Only** | Boolean | `true` | Skip companies with stopped status | | **Max Results** | Integer | `100` | Maximum companies to return | | **Language** | Select | `nl` | Nederlands or Francais | | **Proxy Configuration** | Object | — | Apify proxy settings | ### Example output ```json { "enterpriseNumber": "0400.378.485", "name": "Colruyt Group", "abbreviation": null, "legalForm": "Naamloze vennootschap", "entityType": "Rechtspersoon", "status": "Actief", "legalCondition": "Normale toestand sinds 09/03/1950", "startDate": "09/03/1950", "address": "Edingensesteenweg 196, 1500 Halle", "street": "Edingensesteenweg", "houseNumber": "196", "postalCode": "1500", "city": "Halle", "country": "Belgium", "phone": null, "email": null, "website": null, "naceActivities": [ { "code": "74.999", "description": "Overige professionele, wetenschappelijke en technische activiteiten" }, { "code": "47.110", "description": "Niet-gespecialiseerde detailhandel waarbij voedings- en genotmiddelen overheersen" }, { "code": "70.100", "description": "Activiteiten van hoofdkantoren" } ], "capital": "387.537.870,25 EUR", "numberOfEstablishments": 38, "annualMeetingMonth": "september", "fiscalYearEnd": "31 maart", "vatRegistered": true, "vatSince": "01/01/1971", "employerRegistered": true, "employerSince": "01/01/1945", "management": [ { "function": "Bestuurder", "name": "Jef Colruyt", "appointmentDate": "26/09/2024" }, { "function": "Bestuurder", "name": "Wim Colruyt", "appointmentDate": "30/09/2021" } ], "establishments": [], "qualifications": ["BTW-plichtige sinds 01/01/1971", "Werkgever RSZ sinds 01/01/1945"], "previousEnterpriseNumbers": [], "url": "https://kbopub.economie.fgov.be/kbopub/toonondernemingps.html?ondernemingsnummer=0400378485", "language": "nl", "scrapedAt": "2026-05-20T10:30:00.000Z" } ```` ### Tips for best results - **Batch enrichment**: Paste up to 1,000 enterprise numbers for batch enrichment. The actor processes them sequentially with polite rate limiting. - **Lead qualification**: Use NACE codes to filter by industry. Code 47.xxx = retail, 62.xxx = IT, 70.xxx = management consulting. - **Detect active companies**: Enable "Active Companies Only" to skip dissolved or stopped entities. - **Full company profile**: Enable both "Include Management" and "Include Establishments" for the most complete profile. - **French results**: Set Language to `fr` to get results in French (the KBO site is bilingual). - **Enterprise number formats**: The actor accepts any common format — `0417.497.106`, `0417497106`, or `BE0417497106` — and normalizes automatically. ### How much does it cost? Belgian Company Enrichment runs on the Apify platform. You pay only for compute resources used. No login or cookies required. | Enrichment size | Estimated time | Estimated cost | |-----------------|---------------|----------------| | 1 company lookup | ~3 seconds | ~$0.003 | | 10 companies | ~30 seconds | ~$0.02 | | 100 companies | ~5 minutes | ~$0.15 | | 1,000 companies | ~50 minutes | ~$1.20 | Apify's free tier includes $5 of monthly compute — enough to enrich hundreds of companies at no cost. ### Can I integrate? Yes. Send enriched company data directly to your existing tools: - **Google Sheets** — Build a live Belgian company database, updated on schedule - **HubSpot / Salesforce** — Enrich CRM contacts with official company data - **Slack** — Get notified when new companies matching your criteria are registered - **Webhooks** — Push to any HTTP endpoint for custom enrichment pipelines Set up integrations from the Apify console under the "Integrations" tab. ### Can I use it as an API? Yes. Call Belgian Company Enrichment programmatically from any language: #### Python — Enrich a list of companies ```python from apify_client import ApifyClient client = ApifyClient("YOUR_API_TOKEN") run = client.actor("studio-amba/kbo-enrichment").call(run_input={ "mode": "number", "enterpriseNumbers": ["0417.497.106", "0400.378.485", "0471.811.661"], "includeManagement": True, }) for company in client.dataset(run["defaultDatasetId"]).iterate_items(): print(f"{company['name']} ({company['legalForm']}) — {company['address']}") ``` #### JavaScript — Search by company name ```javascript import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: 'YOUR_API_TOKEN' }); const run = await client.actor('studio-amba/kbo-enrichment').call({ mode: 'name', companyName: 'Colruyt', maxResults: 20, }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach(c => console.log(`${c.enterpriseNumber} | ${c.name} | ${c.legalForm}`)); ``` ### FAQ #### What is KBO? The KBO (Kruispuntbank van Ondernemingen) or BCE (Banque-Carrefour des Entreprises) is Belgium's official enterprise register. Every Belgian company, non-profit, and self-employed professional is registered with a unique enterprise number. #### How to look up a Belgian company? Enter the enterprise number (KBO/BTW number) in the "Enterprise Numbers" field. You can also search by company name or registered address. #### What is a KBO number? A KBO number is a unique 10-digit identifier assigned to every registered entity in Belgium. Format: 0XXX.XXX.XXX. It's also used as the BTW (VAT) number with a BE prefix. #### How to find a company's NACE code? This actor returns the official NACE-BEL activity codes registered in the KBO. NACE codes classify companies by economic activity (e.g., 47.110 = supermarket retail). #### Is this a KBO API alternative? Yes. The official KBO web service charges EUR 50 per 2,000 lookups. This actor provides the same public data at a fraction of the cost, without registration or contracts. #### Can I use this for GDPR compliance? This actor only returns publicly available data from the KBO public register. It does not access any restricted or personal data. The KBO explicitly prohibits using personal data from natural persons for direct marketing — this actor includes no such data. ### Limitations - Data comes from the public KBO website — some fields (phone, email, website) are often empty because companies don't always register contact details - Name search uses phonetic matching, which may return false positives for common names - Management data depends on companies filing their board changes promptly - The KBO site occasionally has maintenance windows (typically weekends) - Rate limited to be polite to the government server — don't expect >1,000 lookups per hour ### Other Belgian data scrapers Working with Belgian business data? Combine with these tools: - **[Staatsblad Scraper](https://apify.com/studio-amba/staatsblad-scraper)** — Belgian Official Gazette: laws, company formations, board changes - **[AutoVlan Scraper](https://apify.com/studio-amba/autovlan-scraper)** — Belgian vehicle classifieds - **[Biddit Scraper](https://apify.com/studio-amba/biddit-scraper)** — Belgian notary property auctions - **[Immovlan Scraper](https://apify.com/studio-amba/immovlan-scraper)** — Belgian real estate listings ### Your feedback Found a bug or want a feature added? Open an issue on the [Issues tab](https://console.apify.com/actors/studio-amba~kbo-enrichment/issues). Your feedback helps improve this actor. # Actor input Schema ## `mode` (type: `string`): How to search: 'number' for direct lookup by enterprise number, 'name' for name search, 'address' for address search. ## `enterpriseNumbers` (type: `array`): One or more Belgian enterprise numbers (KBO/BTW). Formats: 0417.497.106, 0417497106, or BE0417497106. Used in 'number' mode. ## `companyName` (type: `string`): Search for companies by name (or part of name). Used in 'name' mode. ## `postalCode` (type: `string`): Filter by postal code. Used in 'name' and 'address' mode. ## `streetName` (type: `string`): Search by street name. Used in 'address' mode. ## `houseNumber` (type: `string`): House number. Used in 'address' mode. ## `includeEstablishments` (type: `boolean`): Also scrape branch establishment details (vestigingseenheden). Slower but gives physical location data. ## `includeManagement` (type: `boolean`): Also scrape board members and management positions. Adds extra requests per company. ## `activeOnly` (type: `boolean`): Only return companies with active status. ## `maxResults` (type: `integer`): Maximum number of companies to return (for name/address search). ## `language` (type: `string`): Language for the interface and results. ## `proxyConfiguration` (type: `object`): Apify proxy configuration. The KBO site is a government site and rarely blocks, but proxies can help with large batch lookups. ## Actor input object example ```json { "mode": "number", "includeEstablishments": false, "includeManagement": true, "activeOnly": true, "maxResults": 100, "language": "nl" } ``` # 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 = {}; // Run the Actor and wait for it to finish const run = await client.actor("studio-amba/kbo-enrichment").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 = {} # Run the Actor and wait for it to finish run = client.actor("studio-amba/kbo-enrichment").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 '{}' | apify call studio-amba/kbo-enrichment --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=studio-amba/kbo-enrichment", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Belgian Company Enrichment — KBO/BCE Lookup, No Login Required", "description": "Enrich Belgian company data from the official KBO/BCE database. Look up any enterprise by number, name, or address. Returns legal form, NACE activities, capital, management, address, and more. No cookies, no login.", "version": "0.0", "x-build-id": "TcbCY4VzHbWHZi17n" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/studio-amba~kbo-enrichment/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-studio-amba-kbo-enrichment", "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/studio-amba~kbo-enrichment/runs": { "post": { "operationId": "runs-sync-studio-amba-kbo-enrichment", "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/studio-amba~kbo-enrichment/run-sync": { "post": { "operationId": "run-sync-studio-amba-kbo-enrichment", "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": { "mode": { "title": "Search Mode", "enum": [ "number", "name", "address" ], "type": "string", "description": "How to search: 'number' for direct lookup by enterprise number, 'name' for name search, 'address' for address search.", "default": "number" }, "enterpriseNumbers": { "title": "Enterprise Numbers", "type": "array", "description": "One or more Belgian enterprise numbers (KBO/BTW). Formats: 0417.497.106, 0417497106, or BE0417497106. Used in 'number' mode.", "items": { "type": "string" } }, "companyName": { "title": "Company Name", "type": "string", "description": "Search for companies by name (or part of name). Used in 'name' mode." }, "postalCode": { "title": "Postal Code", "type": "string", "description": "Filter by postal code. Used in 'name' and 'address' mode." }, "streetName": { "title": "Street Name", "type": "string", "description": "Search by street name. Used in 'address' mode." }, "houseNumber": { "title": "House Number", "type": "string", "description": "House number. Used in 'address' mode." }, "includeEstablishments": { "title": "Include Establishments", "type": "boolean", "description": "Also scrape branch establishment details (vestigingseenheden). Slower but gives physical location data.", "default": false }, "includeManagement": { "title": "Include Management", "type": "boolean", "description": "Also scrape board members and management positions. Adds extra requests per company.", "default": true }, "activeOnly": { "title": "Active Companies Only", "type": "boolean", "description": "Only return companies with active status.", "default": true }, "maxResults": { "title": "Max Results", "minimum": 1, "type": "integer", "description": "Maximum number of companies to return (for name/address search).", "default": 100 }, "language": { "title": "Language", "enum": [ "nl", "fr" ], "type": "string", "description": "Language for the interface and results.", "default": "nl" }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Apify proxy configuration. The KBO site is a government site and rarely blocks, but proxies can help with large batch lookups." } } }, "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 } } } } } } } } } } ```