Comment intégrer l'API BCE/KBO dans votre application

En bref

L'API BCE/KBO donne accès aux données officielles de plus de 2 millions d'entreprises belges enregistrées à la Banque-Carrefour des Entreprises. En quelques minutes, vous pouvez authentifier vos requêtes avec une clé API, interroger la base par nom ou numéro BCE et enrichir votre application avec des données à jour.

Introduction

L'API BCE/KBO vous permet d'accéder aux données officielles de plus de 2 millions d'entreprises belges. Dans ce guide, nous allons voir comment l'intégrer étape par étape dans votre application.

Prérequis

Avant de commencer, assurez-vous d'avoir :

• Un compte sur notre plateforme

• Une clé API active (publique et secrète)

• Node.js 18+ ou tout autre environnement capable de faire des requêtes HTTP

Étape 1 : Obtenir vos clés API

Connectez-vous à votre tableau de bord et accédez à la section "Clés API". Créez une nouvelle paire de clés. Vous recevrez :

• Clé publique (pk_live_...) : identifie votre application

• Clé secrète (sk_live_...) : authentifie vos requêtes (ne jamais exposer côté client)

Étape 2 : Première requête

Voici un exemple en JavaScript/TypeScript :

1
2
3
4
5
6
7
8
9

const response = await fetch(class="code-string">'https:class="code-comment">//companybelgium.be/api/companies/search?q=Proximus', {
  headers: {
    class="code-string">'X-API-Key': class="code-string">'pk_live_votre_cle_publique',
    class="code-string">'X-API-Secret': class="code-string">'sk_live_votre_cle_secrete',
  },
});

const data = await response.json();
console.log(data.results);

Étape 3 : Recherche avancée

L'API supporte plusieurs types de recherche :

• Par nom : /api/companies/search?q=nom

• Par numéro BCE : /api/companies/{id}

• Par adresse : /api/companies/address?zipCode=1000

• Vérification Peppol : /api/peppol/check?vatNumber=BE0123456789

Bonnes pratiques

Conclusion

L'intégration de l'API BCE/KBO est simple et rapide. En quelques minutes, vous pouvez enrichir votre application avec les données officielles des entreprises belges. Pour aller plus loin, consultez le guide Node.js et TypeScript pour l'API BCE, le tutoriel Python avec FastAPI, le guide sur la sécurisation des clés API et la référence complète des endpoints BCE.