Aller au contenu
API BCEAPI BCEAPI des données d'entreprises belges
Cas d'usageTarifsDocumentationBac à sableObtenir une clé
🇬🇧 English🇫🇷 Français🇳🇱 Nederlands🇩🇪 Deutsch🇪🇸 Español
Obtenir une clé
API BCE / Cas d'usage / Enrichir automatiquement un CRM à partir du numéro d'entreprise

📇 Enrichir automatiquement un CRM à partir du numéro d'entreprise

Un numéro d'entreprise suffit pour remplir proprement une fiche client ou prospect : dénomination officielle, adresse du siège, activités et coordonnées publiées.

Le problème#

Dans un CRM, la même société existe souvent trois fois : « Dupont SRL », « DUPONT » et « Dupont & fils », chacune avec une adresse un peu différente. Les fiches sont saisies à la main, au fil des appels, et personne ne sait laquelle est juste. Les rapports par secteur ou par région deviennent faux, et la facturation reprend l'adresse la plus récente, pas forcément la bonne.

Le numéro d'entreprise est l'identifiant stable d'une société belge. Si votre outil part de ce numéro, il peut aller chercher le reste dans la source officielle au lieu de le faire saisir.

Les données de l'API qui répondent#

  • GET /denominations?q=… : l'autocomplétion sur les noms d'entreprises, pour proposer la bonne société dès les premières lettres tapées et récupérer son numéro.
  • GET /enterprise/{num} : la fiche principale (dénomination, forme juridique, statut, date de début, siège).
  • GET /enterprise/{num}/address : l'adresse du siège social seule, si vous ne voulez rafraîchir que ce champ.
  • GET /enterprise/{num}/activities : toutes les activités NACE déclarées, pour classer vos comptes par secteur.
  • GET /enterprise/{num}/denominations : toutes les dénominations (officielle, abrégée, commerciale) dans les langues publiées.
  • GET /enterprise/{num}/contact : téléphone, e-mail et site web, quand l'entreprise les a publiés.
  • GET /naces : la recherche dans la nomenclature NACE, pour afficher le libellé d'un code ou construire vos propres segments.

Exemple de requête#

"tok-comment"># 1. Type-ahead on the company name, returns enterprise numbers
curl "https://companybelgium.be/api/v2/denominations?q=espero&limit=5" \
  -H "X-API-Key: $API_BCE_KEY" -H "X-API-Secret: $API_BCE_SECRET"
"tok-comment">
# 2. Once a number is chosen, read the record and its sub-resources
curl https://companybelgium.be/api/v2/enterprise/1033.022.383 \
  -H "X-API-Key: $API_BCE_KEY" -H "X-API-Secret: $API_BCE_SECRET"
curl https://companybelgium.be/api/v2/enterprise/1033.022.383/activities \
  -H "X-API-Key: $API_BCE_KEY" -H "X-API-Secret: $API_BCE_SECRET"
curl https://companybelgium.be/api/v2/enterprise/1033.022.383/contact \
  -H "X-API-Key: $API_BCE_KEY" -H "X-API-Secret: $API_BCE_SECRET"

Le premier appel sert à l'écran de saisie : l'utilisateur tape quelques lettres, choisit la bonne société, et votre outil retient son numéro. Les suivants remplissent la fiche à partir de ce numéro.

Mise en œuvre conseillée#

  • Faites du numéro d'entreprise la clé de rapprochement de vos comptes : deux fiches avec le même numéro sont la même société.
  • Ne remplacez pas sans prévenir une adresse saisie par un commercial : proposez la valeur officielle et laissez l'utilisateur valider.
  • Stockez la date du dernier enrichissement et rafraîchissez périodiquement les comptes actifs plutôt que tout le fichier à chaque fois.
  • Appelez les sous-ressources en parallèle : elles sont indépendantes les unes des autres et renvoient chacune l'enveloppe JSON standard.
  • Placez l'appel dans votre backend ou dans une tâche planifiée, jamais dans le navigateur.

Limites à connaître#

  • Les coordonnées (téléphone, e-mail, site) ne sont renvoyées que si l'entreprise les a publiées ; beaucoup n'en publient aucune.
  • Avec un jeton OAuth d'application, l'endpoint des coordonnées exige le scope enterprise:contact. Une clé API classique y a accès sans scope.
  • Les activités NACE sont celles déclarées au registre : elles décrivent l'objet de l'entreprise, pas forcément ce qu'elle vend réellement aujourd'hui.
  • L'API ne renvoie pas d'interlocuteur commercial ni de chiffre de contacts nominatifs : ce n'est pas une base de prospection.
  • Chaque appel compte dans votre quota mensuel : un enrichissement de masse se planifie en fonction de votre offre et de la limite horaire.

Questions fréquentes#

Peut-on retrouver une entreprise par son nom plutôt que par son numéro ?

Oui. GET /denominations?q=… renvoie des suggestions avec le numéro d'entreprise de chacune ; il suffit ensuite d'appeler la fiche avec ce numéro.

Dans quelle langue sont les dénominations ?

Dans les langues publiées au registre : français, néerlandais, allemand ou anglais selon l'entreprise. GET /enterprise/{num}/denominations les renvoie toutes.

Comment garder les fiches à jour après l'enrichissement ?

Rafraîchissez périodiquement les comptes actifs, ou abonnez-les à un webhook pour être prévenu quand leur fiche change dans le registre.

Passer à la pratique

Créez une clé dans le portail développeur, puis suivez la documentation de référence pour chaque endpoint cité.

Obtenir une clé APILire la documentation

Documentation de référence

  • Entreprise
  • Filtres et recherche

Autres cas d'usage

  • Vérifier un client ou un fournisseur avant de travailler avec lui
  • Valider un numéro de TVA (VIES) à la saisie d’une facture
  • KYC/KYB à l'ouverture d'un compte d'entreprise
  • Surveiller des entreprises par webhooks

Sur cette page

Le problèmeLes données de l'API qui répondentExemple de requêteMise en œuvre conseilléeLimites à connaîtreQuestions fréquentesPasser à la pratique
API BCEAPI BCE

Un produit développeur d'Espero-Soft Informatiques, fondé sur l'open data officiel BCE/KBO.

Produit

Cas d'usagePourquoi API BCETarifsFAQ

Développeurs

DocumentationRéférence APIPlayground APIJournal des versionsObtenir une clé

Entreprise

Données, conformité et Peppol ↗Company Belgium ↗Espero-Soft ↗

Légal

Mentions légalesConditions générales d’utilisation et de ventePolitique de confidentialitéPolitique relative aux cookies
© 2026 Espero-Soft Informatiques SRL · Tous droits réservés.Conçu en Belgique 🇧🇪