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#

GET/search/address

Find enterprises registered at a given Belgian address. Street is matched partially (FR or NL); results are paginated.

Parameter

NameIn/TypErforderlichBeschreibung
postalCodequery stringErforderlich4-digit Belgian postal code, e.g. 1000.
streetquery stringErforderlichStreet name (partial match, FR or NL).
houseNumberquery stringoptionalExact house number.
pagequery integeroptional1-based page number (20 results per page).
pageSizequery integeroptionalResults 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

Demo-Anfragen laufen über api-bce.be mit einem geteilten Schlüssel: 15 Anfragen alle 10 Minuten, nur öffentliche Registerdaten.

GET /search/address
cURL
curl "" \
  -H "X-API-Key: $API_BCE_KEY" -H "X-API-Secret: $API_BCE_SECRET"

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.