API BCE : rechercher des entreprises belges par adresse
Recherche par adresse API BCE : trouvez les entreprises belges domiciliées à une adresse (code postal, rue, numéro), résultats paginés avec leur statut.
Endpoints de la ressource Recherche. Tous les appels exigent une authentification et renvoient l’enveloppe JSON standard.
URL de base: https://companybelgium.be/api/v2 · Authentification
Search enterprises by postal address#
Find enterprises registered at a given Belgian address. Street is matched partially (FR or NL); results are paginated.
Paramètres
| Nom | Dans/Type | Requis | Description |
|---|---|---|---|
postalCode | query string | Requis | 4-digit Belgian postal code, e.g. 1000. |
street | query string | Requis | Street name (partial match, FR or NL). |
houseNumber | query string | optionnel | Exact house number. |
page | query integer | optionnel | 1-based page number (20 results per page). |
pageSize | query integer | optionnel | Results per page (default 20, max 100). Alias: limit. |
Requête
curl https://companybelgium.be/api/v2/search/address \
-H "X-API-Key: $API_BCE_KEY" \
-H "X-API-Secret: $API_BCE_SECRET"Réponse
{
"success": true,
"data": {
"results": [
{
"enterpriseNumber": "1033.022.383",
"name": "ESPERO-SOFT INFORMATIQUES",
"status": "AC",
"statusCode": "AC",
"juridicalSituationCode": "...",
"type": "PM",
"address": "Rue de la Colonne 1A, 1080 Molenbeek-Saint-Jean",
"startDate": "..."
}
],
"totalResults": "...",
"currentPage": 1,
"totalPages": "...",
"searchParams": {
"zipCode": "1080"
}
},
"timestamp": "...",
"meta": {
"responseTime": "..."
}
}▶ Essayer cette requête
Cas d’usage de la recherche par adresse API BCE#
Retrouver les entreprises domiciliées à une adresse répond à des besoins variés. Par exemple, une banque repère plusieurs sociétés enregistrées à la même adresse. De même, une équipe commerciale prépare une tournée dans une rue précise.
- Contrôle de domiciliation : comptez les entreprises déclarées à une adresse lors d’une revue KYB.
- Prospection locale : listez les entreprises actives d’une rue ou d’un code postal.
- Nettoyage de CRM : retrouvez le numéro BCE d’un client dont vous ne connaissez que l’adresse.
- Immobilier : identifiez les occupants professionnels d’un bâtiment.
Formuler une bonne requête#
Le code postal et la rue sont obligatoires. La rue est comparée partiellement, en français ou en néerlandais. Ainsi, un fragment comme « Colonne » suffit souvent. En revanche, un nom trop court ramène beaucoup de rues voisines. Ajoutez donc houseNumber dès que vous le connaissez, car il est comparé de façon exacte. Enfin, le code postal doit compter quatre chiffres, comme tout code postal belge.
Par ailleurs, normalisez la saisie avant l’appel : supprimez les espaces superflus et séparez le numéro du nom de rue. Vous obtiendrez des résultats plus précis.
Parcourir et exploiter les résultats#
Les résultats sont paginés, 20 par page par défaut et 100 au maximum avec pageSize. Lisez totalPages pour savoir combien d’appels prévoir. Chaque page consomme une requête : pour un traitement en masse, augmentez donc la taille de page. Chaque résultat contient aussi le statut et la situation juridique. Vous pouvez donc écarter les entreprises arrêtées sans appel supplémentaire. Ensuite, chargez la fiche complète uniquement pour les entreprises retenues.
Bonnes pratiques de production pour API BCE#
Les recherches par adresse peuvent coûter cher en quota quand vous les lancez en masse. Avant un traitement de plusieurs milliers d’adresses, testez donc un petit échantillon et mesurez le nombre moyen de pages. Ensuite, estimez la consommation totale et comparez-la à votre formule. Par ailleurs, conservez les paramètres de recherche avec les résultats : la réponse les renvoie dans searchParams. Vous pourrez ainsi rejouer la même recherche plus tard et comparer les deux listes.
Questions fréquentes sur la recherche par adresse API BCE#
Puis-je chercher avec le seul code postal ?
Non. Le paramètre street est obligatoire avec postalCode. Le numéro de maison, lui, reste facultatif.
Le nom de rue doit-il être exact ?
Non. La correspondance est partielle et fonctionne en français comme en néerlandais. Un numéro de maison exact affine toutefois le résultat.
La recherche couvre-t-elle les établissements ?
La référence décrit une recherche d’entreprises enregistrées à l’adresse. Pour les établissements d’une entreprise, utilisez plutôt /enterprise/{num}/establishments.