API BCE Adresssuche: Firmen in Belgien nach Adresse finden
Adresssuche mit der API BCE: Finden Sie die belgischen Unternehmen an einer Adresse (Postleitzahl, Straße, Nummer), seitenweise mit ihrem Status.
Endpunkte für die Ressource Suche. Alle Aufrufe erfordern Authentifizierung und liefern die Standard-JSON-Envelope.
Basis-URL: https://companybelgium.be/api/v2 · Authentifizierung
Search enterprises by postal address#
Find enterprises registered at a given Belgian address. Street is matched partially (FR or NL); results are paginated.
Parameter
| Name | In/Typ | Erforderlich | Beschreibung |
|---|---|---|---|
postalCode | query string | Erforderlich | 4-digit Belgian postal code, e.g. 1000. |
street | query string | Erforderlich | Street name (partial match, FR or NL). |
houseNumber | query string | optional | Exact house number. |
page | query integer | optional | 1-based page number (20 results per page). |
pageSize | query integer | optional | Results per page (default 20, max 100). Alias: limit. |
Anfrage
curl https://companybelgium.be/api/v2/search/address \
-H "X-API-Key: $API_BCE_KEY" \
-H "X-API-Secret: $API_BCE_SECRET"Antwort
{
"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": "..."
}
}▶ Diese Anfrage testen
Adresssuche der API BCE in der Praxis#
Die Adresssuche beantwortet eine Frage, die der Datensatz nicht beantwortet: Wer ist an dieser Adresse registriert? Das ist zum Beispiel bei der Betrugsprävention nützlich. Teilen sich viele Unternehmen eine Adresse, kann das auf ein Domizilierungsbüro hinweisen. Außerdem hilft die Suche bei Immobilienverwaltung und lokaler Marktanalyse.
Anwendungsfälle
- KYB: prüfen, welche anderen Unternehmen am Sitz eines neuen Kunden registriert sind.
- Immobilien: die Mieter eines Gebäudes über Straße und Hausnummer ermitteln.
- Vertrieb: Unternehmen in einer Straße oder einem Postleitzahlgebiet finden.
- Datenqualität: eine im CRM erfasste Adresse mit dem Register abgleichen.
Parameter richtig wählen#
Postleitzahl und Straße sind Pflicht. Die Straße wird dabei teilweise abgeglichen, auf Französisch oder Niederländisch. Geben Sie deshalb einen markanten Teil des Namens an, etwa Colonne statt der vollen Bezeichnung. Die Hausnummer muss dagegen exakt passen. Lassen Sie sie also weg, wenn Sie unsicher sind.
In Brüssel tragen Straßen häufig zwei Namen. Suchen Sie im Zweifel daher in beiden Sprachen. Nutzen Sie außerdem pageSize bis 100, um weniger Seiten abzurufen. Jede Seite zählt nämlich als eigene Anfrage.
Ergebnisse weiterverarbeiten#
Jeder Treffer enthält Nummer, Name, Status, Typ und Adresse. Filtern Sie zuerst nach statusCode, wenn Sie nur aktive Unternehmen brauchen. Laden Sie danach die Details nur für relevante Treffer. Der Typ PM steht für eine juristische Person, PP für eine natürliche Person.
Ergebnisse richtig einordnen
Viele Treffer an einer Adresse sind kein Beweis für ein Problem. Geschäftszentren und Bürogebäude beherbergen oft zahlreiche Unternehmen. Werten Sie die Zahl der Treffer deshalb nur als Hinweis. Prüfen Sie danach Status, Startdatum und Tätigkeit der Unternehmen. Erst das Gesamtbild erlaubt eine fundierte Entscheidung. Dokumentieren Sie außerdem die Suche, wenn sie Teil einer KYB-Prüfung ist.
Bei regelmäßigen Abgleichen speichern Sie schließlich die Treffer. So erkennen Sie neue Unternehmen an einer Adresse beim nächsten Lauf.
Für die Datenqualität im CRM eignet sich außerdem ein umgekehrter Abgleich. Sie suchen zuerst mit der gespeicherten Adresse eines Kunden. Danach prüfen Sie, ob seine Nummer unter den Treffern erscheint. Fehlt sie, ist die Adresse im CRM wahrscheinlich veraltet. Laden Sie dann den Sitz über die Unternehmens-Endpunkte neu.
Begrenzen Sie solche Abgleiche außerdem auf Kunden, deren Daten Sie tatsächlich nutzen. Das schont Ihr Kontingent.
Häufige Fragen zur Adresssuche der API BCE#
Kann die API BCE Unternehmen im Ausland per Adresse finden?
Die Suche erwartet eine belgische Postleitzahl mit vier Ziffern. Sie ist also für Adressen in Belgien gedacht.
Warum fehlen Unternehmen in meinen Treffern?
Prüfen Sie zuerst die Hausnummer, denn sie muss exakt stimmen. Versuchen Sie danach den Straßennamen in der anderen Landessprache.
Gibt es eine Suche nach Firmennamen?
Ja, über /denominations bei den Referenzdaten. Sie eignet sich für Eingabefelder mit Vorschlägen.