# Belgian B2B Leads: companies by sector & postcode + financials (`goobertje/belgium-b2b-lead-builder`) Actor

Belgian B2B lead lists by sector (NACE) and postcode: KBO company details and contacts plus the latest NBB annual-account figures, ratios and health score. $12 per 1,000 leads with financials, $4 without.

- **URL**: https://apify.com/goobertje/belgium-b2b-lead-builder.md
- **Developed by:** [goober](https://apify.com/goobertje) (community)
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $12.00 / 1,000 lead with financials

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?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Belgian B2B lead list with contact data, company size and financial health

Give this Actor a sector (NACE codes) and an area (postal codes), and it returns a ready lead list of Belgian companies: name, legal form, address and any published phone, email and website from the KBO register, plus size and financial health from each company's latest annual accounts at the National Bank (NBB). Built for sales and marketing teams, agencies and analysts who today need two data sources and a manual join on two different enterprise-number formats.

### Why use this Actor

- **One run instead of two sources.** KBO identity and contact data and NBB annual-account figures arrive in one row, already joined.
- **Filter by size and health.** Keep only companies with enough employees (FTE), total assets or a good health score.
- **Official sources, plain HTTP.** KBO Public Search and the NBB Central Balance Sheet Office. No browser, no proxies, about 1 request per second per source.
- **Fair billing.** Companies rejected by a filter, duplicates and errors are never billed. A company without usable accounts is delivered as a cheaper basic lead.
- **Delta mode.** Schedule it and get only leads you have not received before.

### Quick start

Click **Start** with the prefilled input:

```json
{ "naceCodes": ["62.100"], "postalCodes": ["9000"], "maxItems": 3 }
```

You get 3 companies active in NACE 62.100 with an establishment in postcode 9000 (their registered seat can be elsewhere), each with contact fields, activities and the figures from their latest annual accounts. The run takes about 15 seconds and costs about $0.036.

### What you get

One dataset row per lead. Unknown values are `null`. Nothing is estimated.

| Field | Meaning |
|---|---|
| `enterpriseNumber`, `enterpriseNumberDigits` | The company number dotted (`0477.456.269`, KBO form) and as 10 digits (NBB form) |
| `name`, `legalForm`, `startDate` | Legal name, legal form (KBO's English wording), enterprise start date |
| `legalStatus` | KBO legal status, for example `Active` |
| `address` | Registered seat: `street`, `postalCode`, `city` |
| `phone`, `email`, `website` | As published by KBO. Many companies publish none, then `null` |
| `mainActivity`, `activities` | NACE-BEL 2025 activities. KBO flags no main activity, so `mainActivity` is the first one KBO lists |
| `financialsStatus` | `ok`, `no_filings`, `no_structured_filings` or `error` (see Pricing) |
| `financials` | `null` unless `ok`: `fiscalYear`, `fiscalYearEnd`, `depositDate`, `modelName`, `keyFigures`, `ratios`, `healthScore` |
| `financials.keyFigures` | Total assets, equity, net result, FTE and 18 more figures read from the filing, in euros as filed |
| `financials.healthScore` | `score` (0-100 or `null`), `band`, `flags` |
| `kboUrl`, `nbbUrl`, `scrapedAt` | Source page, the NBB annual-accounts page as linked by KBO, run time |

Real sample from a live run on 2026-11-10 (input above):

```json
{
  "enterpriseNumber": "0477.456.269",
  "enterpriseNumberDigits": "0477456269",
  "name": "4D VISION",
  "legalForm": "Public limited company",
  "startDate": "2002-05-02",
  "legalStatus": "Active",
  "address": { "street": "Borsbeeksebrug 34 box 1", "postalCode": "2600", "city": "Antwerpen" },
  "phone": null,
  "email": null,
  "website": null,
  "mainActivity": { "code": "58.290", "description": "Other software publishing" },
  "activities": [
    { "code": "58.290", "description": "Other software publishing", "naceVersion": "2025" },
    { "code": "62.200", "description": "Computer consultancy and computer facilities management activities", "naceVersion": "2025" }
  ],
  "financialsStatus": "ok",
  "financials": {
    "fiscalYear": 2025,
    "fiscalYearEnd": "2025-06-30",
    "depositDate": "2025-11-28T11:06:10.390Z",
    "modelName": "Verkort model kapitaalvennootschap",
    "keyFigures": {
      "totalAssets": 557016.0, "fixedAssets": 21720.0, "currentAssets": 535296.0, "inventories": null,
      "tradeAndOtherReceivables": 374318.0, "currentInvestments": null, "cashAtBankAndInHand": 151714.0,
      "equity": 201222.0, "totalLiabilities": 557016.0, "totalDebts": 355794.0, "longTermDebts": null,
      "currentDebts": 355794.0, "turnover": null, "operatingIncome": null, "grossMargin": 845251.0,
      "operatingResult": 102116.0, "profitBeforeTax": 100088.0, "incomeTaxes": 25317.0, "netResult": 74771.0,
      "personnelCosts": 732550.0, "depreciation": 9315.0, "fte": 10.5
    },
    "ratios": {
      "currentRatio": 1.5, "quickRatio": 1.48, "solvencyPct": 36.12, "debtToEquity": 1.77,
      "operatingMarginPct": null, "netMarginPct": null, "returnOnEquityPct": 37.16, "returnOnAssetsPct": 13.42
    },
    "healthScore": { "score": 97.1, "band": "excellent", "flags": [] }
  },
  "kboUrl": "https://kbopub.economie.fgov.be/kbopub/toonondernemingps.html?lang=en&ondernemingsnummer=0477456269",
  "nbbUrl": "https://consult.cbso.nbb.be/consult-enterprise/0477456269",
  "scrapedAt": "2026-11-10T16:22:30.067547Z"
}
```

The same run also returned `2S` (Ghent) and `4F`; both samples are in the `samples/` folder of the project.

### Input

| Field | Default | Meaning |
|---|---|---|
| `naceCodes` + `postalCodes` | prefill: `62.100`, `9000` | Discover by sector and area. Max 200 hits per search, so use specific codes and few postal codes |
| `searchTerm`, `searchPostalCode` | empty | Discover by company name, optionally narrowed by postal code |
| `enterpriseNumbers` | empty | Enrich a list you already have (dots and `BE` prefix are fine) |
| `legalForms`, `startedSince`, `onlyActive` | none, none, true | KBO-side filters for discovered companies |
| `requireFinancials` | false | Drop companies with no usable NBB annual accounts |
| `minFte`, `maxFte`, `minTotalAssetsEur`, `minHealthScore` | empty | Financial filters. A company with no figure fails any filter you set |
| `onlyNewLeads`, `stateStoreName` | false, `lead-builder-state` | Delta mode for scheduled runs |
| `maxItems` | 50 (prefill 3) | Cap on delivered, billed leads |
| `maxCandidates` | 500 | Cap on companies examined, so strict filters cannot run forever |
| `requestDelaySecs` | 1.5 | Pause between requests per source, minimum 1 |

Sole proprietors (natural persons) are always excluded.

### Pricing

Pay per event. Exactly one event per delivered row, never both:

| Event | Price | When |
|---|---|---|
| `lead-with-financials` | $12.00 per 1,000 | The latest NBB annual accounts were read (`financialsStatus: ok`) |
| `lead-basic` | $4.00 per 1,000 | The company is delivered without usable accounts (`no_filings`, `no_structured_filings`, `error`) |

Rejected by a filter, already delivered in delta mode, not found, or failed rows are not pushed and not charged. `maxItems` caps the number of billed rows, and Apify's maximum-cost-per-run setting stops the run when reached.

Worked example: 100 leads, 60 with financials and 40 basic: 60 x $0.012 + 40 x $0.004 = $0.72 + $0.16 = $0.88. A full 1,000-lead run with the same mix costs $8.80.

Each lead costs 1 KBO request and 2 to 4 NBB requests, so plan about 4 to 6 seconds per lead at the default rate. Companies rejected by a filter still cost requests but no money.

### Use with AI agents (MCP, Claude, Cursor, n8n, Make)

AI agents can call this Actor through the Apify MCP server. Add it to your MCP client (sign in with OAuth in the browser on first use):

```json
{ "mcpServers": { "apify": { "url": "https://mcp.apify.com?tools=goobertje/belgium-b2b-lead-builder" } } }
```

Example prompts and the input each one maps to:

- "Find 20 IT companies with an establishment in Ghent and at least 10 employees." ->
  `{ "naceCodes": ["62.100", "62.200"], "postalCodes": ["9000"], "minFte": 10, "maxItems": 20 }`
- "Enrich these two enterprise numbers with contact data and financials." ->
  `{ "enterpriseNumbers": ["0403.199.702", "0200.065.765"] }`
- "Every week, give me new healthy management consultancies in Antwerp that I have not seen yet." ->
  `{ "naceCodes": ["70.200"], "postalCodes": ["2000", "2018"], "minHealthScore": 60, "onlyNewLeads": true }`

In n8n, Make or Zapier use the Apify node or module, pick this Actor and paste the same JSON.

### Use cases

- Build a prospect list for B2B sales by sector, region and company size.
- Qualify leads before outreach: skip companies with negative equity or tiny balance sheets.
- Enrich a CRM export of Belgian customers with legal form, address, NACE code and latest figures.
- Run a weekly delta feed of new matching companies into a CRM or spreadsheet.
- Screen suppliers or partners by financial health.

### FAQ

**Where does the data come from and is it allowed?** KBO Public Search (FPS Economy, which states its web content may be reused, including commercially) and the NBB Central Balance Sheet Office (free public annual accounts; NBB asks that it is named as the source). The Actor uses plain HTTP at a low rate, identifies itself in its User-Agent and never tries to get around blocking.

**How fresh is it?** KBO shows the register as of the previous day. NBB figures are the newest accounts a company has deposited, usually within 7 months of its year end, so they can be a year old. `fiscalYearEnd` and `depositDate` tell you exactly.

**How much does a typical run cost?** The prefilled run costs about $0.036. One hundred leads cost between $0.40 and $1.20 depending on how many have accounts.

**What if a source blocks or changes?** After repeated 403/429 answers or a CAPTCHA, the run stops. If at least one lead was delivered the run ends as Succeeded with a status message and keeps (and bills) only those leads; before the first lead it fails and nothing is billed. If the NBB lookup fails for a single company, it is delivered as a basic lead with `financialsStatus: error`, or skipped when a financial filter is set. Five NBB failures in a row, five KBO page failures in a row or a rejected KBO search stop the run: with at least one lead delivered it ends as Succeeded with a status message naming the reason and the lead count (you keep and pay for those leads); with none it fails. If your charge limit covers only one lead type, leads of the other type are still delivered and the run stops when neither can be charged.

**Can I schedule it and get only new leads?** Yes. Turn on `onlyNewLeads` and use one `stateStoreName` per feed. Leads you already received are skipped and not billed again.

**What is not included?** Directors and other persons, shareholders, consolidated accounts, PDF-only filings, sole proprietors, and emails or phone numbers KBO does not publish.

### Limits and honest caveats

- **Contact data is thin.** KBO publishes phone, email and website only for some companies. Missing values stay `null`; nothing is guessed or scraped from other sites.
- **Statutory accounts only.** Consolidated accounts and PDF, paper or microfilm filings carry no figures (`no_structured_filings`).
- **Small companies often file a model without FTE or turnover.** Those fields are `null`, so such companies fail `minFte`, `maxFte` and turnover-based ratios.
- **The health score is a heuristic** (solvency 30, liquidity 25, profitability 25, operating result 10, equity 10 points, rescaled when inputs are missing; `null` below 50% coverage). It is not a credit rating.
- **Search limits.** One KBO search returns at most 200 hits. The activity search needs postal codes. Legal form and start date are filtered after fetching, which costs requests.
- **Speed.** One request about every 1.5 seconds per source on purpose. A run stops after 5,000 requests per source and ends as Succeeded with what it has. Use smaller batches for long lists.
- The KBO English interface is an unofficial translation; only the Dutch, French and German texts are official.

### Related Actors

- No financial figures needed? [Belgium KBO Company Registry](https://apify.com/goobertje/belgium-kbo-company-registry) returns the register data alone at $3 per 1,000 companies.
- Already have a list of enterprise numbers and only want the accounts? [Belgium NBB Financial Scorer](https://apify.com/goobertje/belgium-nbb-financial-scorer) returns several years of annual accounts per company.

If this Actor saved you time, a short review on its Store page helps other people find it. Found a problem or a missing field? Open an issue on the Issues tab.

### Legal and disclaimer

Company data is public information published by the Belgian FPS Economy (KBO/BCE Public Search) and the National Bank of Belgium (Central Balance Sheet Office). Please cite both sources. This Actor is **not affiliated with, endorsed by or connected to the FPS Economy or the National Bank of Belgium**.

Only legal entities are returned. Sole proprietors are registered under a private person's name and are excluded; directors are not collected. The FPS Economy states that personal data from the register may not be reused for direct marketing, and you are responsible for a lawful basis under the GDPR, for example when you contact a company's published email address. The information may be incomplete or out of date, has no legal value and is not legal or financial advice. For legally valid data use the official channels.

Found a problem or want a field added? Open an issue on the Actor page.

# Actor input Schema

## `naceCodes` (type: `array`):

Find companies with one of these NACE-BEL 2025 activity codes (3 to 7 digits, dots allowed, up to 10 codes). Needs at least one postal code. A search returns at most 200 hits, so combine specific codes with a few postal codes. Example: \["62.100", "62.200"].

## `postalCodes` (type: `array`):

4-digit Belgian postal codes where an establishment or the registered seat must be. Required together with NACE codes; every group of 4 postal codes is one search. Example: \["9000", "9050"].

## `searchTerm` (type: `string`):

Phonetic search on company, establishment and trade names (also finds old names). Returns at most 200 hits; add a postal code to narrow it. Leave empty when you search by NACE code. Example: "delhaize".

## `searchPostalCode` (type: `string`):

Optional 4-digit postal code that narrows the name search. Only works together with a company name. Example: "1000".

## `enterpriseNumbers` (type: `array`):

Belgian enterprise numbers (ondernemingsnummer / numero d'entreprise) to enrich, with or without dots or the BE prefix. Numbers with a wrong check digit are ignored. These are always looked up, whatever their legal status. Example: \["0403.199.702", "BE0202239951"].

## `legalForms` (type: `array`):

Keep only companies whose legal form contains one of these texts, in English as shown by KBO (case-insensitive). Applies to discovered companies, not to explicit enterprise numbers. Example: \["private limited company", "public limited company"].

## `startedSince` (type: `string`):

Keep only discovered companies whose enterprise start date is on or after this date (YYYY-MM-DD). Leave empty for no limit. Example: "2024-01-01".

## `startedWithinDays` (type: `integer`):

Rolling alternative to Started on or after, for scheduled feeds: keep only discovered companies that started in the last N days. 0 = off. When both are set, the later date wins.

## `onlyActive` (type: `boolean`):

Skip stopped or otherwise not-active companies found by discovery. Default: true. Explicit enterprise numbers are returned whatever their status.

## `includeEstablishmentUnits` (type: `boolean`):

Discovery only. When off, the search returns enterprises only, so matches come from the registered seat. Recommended for 'new companies' feeds with a start-date filter, because every establishment row in the results would otherwise cost one request just to learn its start date, which can trigger KBO throttling. Trade-off: a company seated elsewhere that only has a branch in your postal code is not found. On (default) keeps the full search.

## `newestFirst` (type: `boolean`):

For feeds of newly founded companies. Checks the highest (newest) enterprise numbers first and stops when the results are clearly older than your start-date filter, so a run costs about one request per new company plus a few, instead of one per search hit. It relies on enterprise numbers being issued in order, so it can miss a company whose start date is later than its registration order suggests. Only has an effect together with Started on or after or Started within last N days. Off (default) checks every search hit.

## `requireFinancials` (type: `boolean`):

Drop companies that have no usable NBB annual accounts (none filed, only PDF or consolidated filings, or the lookup failed). Without this switch such companies are still delivered, as cheaper basic leads. Default: false.

## `minFte` (type: `number`):

Keep only companies whose latest annual accounts report at least this many full-time equivalents. A company that reports no FTE figure fails this filter (small companies often file a model without it). Leave empty for no limit. Example: 10.

## `maxFte` (type: `number`):

Keep only companies whose latest annual accounts report at most this many full-time equivalents. A company that reports no FTE figure fails this filter. Leave empty for no limit. Example: 250.

## `minTotalAssetsEur` (type: `number`):

Keep only companies whose latest annual accounts show at least this balance-sheet total, in euros. A company with no figure fails this filter. Leave empty for no limit. Example: 500000.

## `minHealthScore` (type: `number`):

Keep only companies whose transparent financial health score (0-100, see README) is at least this value. A company with no score fails this filter. Leave empty for no limit. Example: 60.

## `onlyNewLeads` (type: `boolean`):

Remember every delivered lead in a named key-value store and skip them on later runs, so a scheduled run only returns leads you did not receive before. Skipped leads are not billed. The first run returns everything that matches. Default: false.

## `stateStoreName` (type: `string`):

Name of the persistent key-value store that holds the delta state. Use a different name per lead feed. Only lowercase letters, digits and hyphens (not at the start or end), 3 to 63 characters. Default: "lead-builder-state".

## `maxItems` (type: `integer`):

Maximum number of leads (dataset rows, each one billed) a run delivers; the run stops once reached. This caps the cost of a run. Default: 50. Example: 100.

## `maxCandidates` (type: `integer`):

Upper limit of companies examined in one run, so strict filters cannot run forever. Companies rejected by a filter cost requests (about 1.5 seconds each) but are not billed. Default: 500. Example: 1000.

## `requestDelaySecs` (type: `number`):

Pause between requests to the same source (KBO and NBB each), to stay polite. Minimum 1, maximum 30. Default: 1.5.

## Actor input object example

```json
{
  "naceCodes": [
    "62.100"
  ],
  "postalCodes": [
    "9000"
  ],
  "enterpriseNumbers": [],
  "legalForms": [],
  "startedWithinDays": 0,
  "onlyActive": true,
  "includeEstablishmentUnits": true,
  "newestFirst": false,
  "requireFinancials": false,
  "onlyNewLeads": false,
  "stateStoreName": "lead-builder-state",
  "maxItems": 3,
  "maxCandidates": 500,
  "requestDelaySecs": 1.5
}
```

# Actor output Schema

## `leads` (type: `string`):

Belgian company leads with the latest annual-account figures.

# 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 = {
    "naceCodes": [
        "62.100"
    ],
    "postalCodes": [
        "9000"
    ],
    "maxItems": 3
};

// Run the Actor and wait for it to finish
const run = await client.actor("goobertje/belgium-b2b-lead-builder").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 = {
    "naceCodes": ["62.100"],
    "postalCodes": ["9000"],
    "maxItems": 3,
}

# Run the Actor and wait for it to finish
run = client.actor("goobertje/belgium-b2b-lead-builder").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 '{
  "naceCodes": [
    "62.100"
  ],
  "postalCodes": [
    "9000"
  ],
  "maxItems": 3
}' |
apify call goobertje/belgium-b2b-lead-builder --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,goobertje/belgium-b2b-lead-builder"
        }
    }
}
```

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/CteUNO3aBslmJdb1X/builds/LoaEN6Asb8XYS4Q61/openapi.json
