KVKBase Team

Trouver des entreprises belges par code postal et secteur

Comment trouver des entreprises belges par code postal, commune, province et secteur NACE : pages de listes KVKBase et recherche API, avec leurs limites.

belgiquecode postalsecteursrecherche

Quand on explore un marché belge, on pense rarement en numéros d’entreprise. On se demande plutôt : quelles boulangeries à Liège, quelles sociétés de construction dans le Hainaut, quelles sociétés dans ma commune ? Ce guide présente deux manières d’y répondre, les pages de listes publiques de KVKBase pour explorer sans code, et la recherche par API pour un usage automatisé, ainsi que la logique des codes postaux belges qui permet de structurer la recherche.

Explorer sans code : les pages de listes

Quatre portes d’entrée existent depuis la page d’accueil belge :

  • Villes : les entreprises par commune et code postal.
  • Provinces : une vue par province, pratique pour une prospection régionale.
  • Secteurs : les entreprises par activité, selon la nomenclature NACE.
  • Formes juridiques : les entreprises par forme, comme la SRL, la SA ou l’ASBL.

L’ensemble des fiches publiques se parcourt aussi depuis la page entreprises. Ces pages sont conçues pour naviguer et comparer, pas pour produire un export complet. Les personnes physiques, c’est-à-dire les indépendants en nom propre, n’y figurent pas : c’est un choix délibéré de protection de la vie privée, car leur adresse professionnelle peut être leur domicile.

La logique des codes postaux belges

Un code postal belge compte quatre chiffres, et les plages correspondent assez fidèlement aux provinces, avec quelques particularités. Voici le tableau à garder sous la main.

Codes postauxProvince ou région
1000 à 1299Bruxelles
1300 à 1499Brabant wallon
1500 à 1999 et 3000 à 3499Brabant flamand
2000 à 2999Anvers
3500 à 3999Limbourg
4000 à 4999Liège
5000 à 5999Namur
6000 à 6599 et 7000 à 7999Hainaut
6600 à 6999Luxembourg
8000 à 8999Flandre occidentale
9000 à 9999Flandre orientale

Deux pièges à connaître. Le Brabant flamand et le Hainaut sont chacun coupés en deux plages : 1500 à 1999 entoure Bruxelles tandis que 3000 à 3499 correspond à la région de Louvain, et dans le Hainaut, 6000 à 6599 couvre la région de Charleroi alors que 7000 à 7999 englobe Mons et Tournai. Une règle fondée sur le seul premier chiffre donnerait donc parfois une mauvaise province. Une petite table de correspondance dans votre code est plus sûre.

Le premier chiffre reste une approximation utile : 1 pour Bruxelles et ses environs, 2 pour Anvers, 3 pour le Brabant flamand et le Limbourg, 4 pour Liège, 5 pour Namur, 6 et 7 pour le Luxembourg et le Hainaut, 8 pour la Flandre occidentale et 9 pour la Flandre orientale.

Rechercher par API

Pour un usage automatisé, appelez GET https://api.kvkbase.nl/v1/be/search. Passez q (un fragment de nom, deux caractères minimum), postalCode (quatre chiffres), ou les deux. Une recherche coûte 1 token. Votre clé s’obtient en créant un compte et le détail des champs figure dans la documentation de l’API.

curl -s "https://api.kvkbase.nl/v1/be/search?postalCode=4000&q=boulangerie&pageSize=25" \
  -H "Authorization: Bearer YOUR_API_KEY"

Chaque résultat comprend cbeNumber, cbeNumberFormatted, name, entityType, legalForm, legalFormShort, postalCode, city, country et isActive, de quoi afficher une liste ou préparer une sélection.

Le plafond de 25 résultats

C’est le point qui surprend le plus. Une recherche ne renvoie jamais plus de 25 résultats, même si vous augmentez page : page et pageSize ne découpent que ces 25 résultats. La réponse contient total, page, pageSize et capped. Quand capped vaut true, il existe peut-être plus d’entreprises que celles affichées.

La parade consiste à affiner plutôt qu’à paginer :

  • Ajoutez un fragment de nom au code postal, par exemple q=construction ou q=conseil.
  • Parcourez plusieurs fragments ou plusieurs lettres, puis dédoublonnez sur cbeNumber.
  • Évitez les termes trop généraux : q=sa associé à un grand code postal atteint le plafond d’emblée.

Vous n’obtiendrez donc pas la liste exhaustive d’un code postal, et ce n’est pas la vocation de cet endpoint. Si vous disposez déjà d’une liste de numéros, l’endpoint de traitement par lots est la bonne voie : voyez vérifier des entreprises en masse.

Chercher par secteur

La recherche par API ne comporte pas de filtre sectoriel. Deux possibilités s’offrent à vous. La page secteurs permet de parcourir les entreprises par activité NACE. Côté code, vous récupérez des entreprises par nom et code postal, puis vous lisez dans la fiche complète le champ activities, qui contient les codes NACE de l’activité principale et des activités secondaires, avec un indicateur pour la principale. La structure de ces codes est expliquée dans le guide codes NACE : rechercher par secteur.

Exemple en JavaScript : on cherche dans un code postal, puis on demande la fiche de chaque résultat actif.

const headers = { Authorization: `Bearer ${process.env.KVKBASE_API_KEY}` };
const recherche = await fetch(
  "https://api.kvkbase.nl/v1/be/search?postalCode=4000&q=boulangerie&pageSize=25",
  { headers }
).then((r) => r.json());

for (const hit of recherche.results.filter((h) => h.isActive !== false)) {
  const fiche = await fetch(
    `https://api.kvkbase.nl/v1/be/lookup/${hit.cbeNumber}?lang=fr`,
    { headers }
  ).then((r) => r.json());
  const principale = fiche.activities.find((a) => a.isMain);
  console.log(hit.name, hit.city, principale?.sbiCode);
}

Chaque fiche coûte 1 token : filtrez d’abord sur ce dont vous avez vraiment besoin.

Cas d’usage concrets

Quelques scénarios qui fonctionnent bien en pratique :

Gardez à l’esprit que les données ne sont pas en temps réel et que leur exhaustivité n’est pas garantie. Avant un contrat ou une livraison importante, contrôlez toujours l’entreprise elle-même, comme le détaille vérifier une entreprise belge avant de contracter.

Pour aller plus loin

Pour comprendre ce qu’est un site d’exploitation rattaché à une entreprise, lisez le guide sur l’unité d’établissement. Les appels de l’API sont illustrés dans les exemples de code en curl, JavaScript et Python, un numéro isolé se teste avec l’outil gratuit, et la vue d’ensemble se trouve dans le guide d’intégration.

Questions fréquentes

Puis-je récupérer toutes les entreprises d'un code postal via l'API ?
Pas en une fois. Une recherche renvoie 25 résultats au maximum et le champ capped signale qu'il peut y en avoir davantage. Associez le code postal à un fragment de nom pour affiner la liste étape par étape.
L'API permet-elle de rechercher par secteur NACE ?
L'endpoint de recherche n'accepte qu'un nom (q) et un code postal (postalCode). Pour les secteurs, utilisez les pages de listes de KVKBase, ou filtrez vous-même sur le champ activities des fiches.
Quels codes postaux correspondent à quelle province ?
Le code postal belge compte quatre chiffres et les plages suivent à peu près les provinces : de 1000 à 1299 pour Bruxelles, de 2000 à 2999 pour Anvers, par exemple. Le Brabant flamand et le Hainaut comptent chacun deux plages distinctes.
Les indépendants en nom propre figurent-ils dans les listes ?
Non. Par souci de vie privée, les personnes physiques ne sont pas affichées sur les pages publiques de KVKBase, même lorsqu'elles sont actives.