Skip to content

Firmen anreichern (enrich_companies)

enrich_companies ergänzt eine bestehende Firmenliste, z. B. aus deinem CRM, um alles, was HiWalter über die Firmen weiß. Du wählst über datasets, welche Datenblöcke du brauchst.

Bis 100 Domains kommt die Antwort direkt. Größere Listen laufen asynchron über Task-Status abrufen.

Nutze diesen Endpunkt, um:

  • CRM-Datensätze mit Größe, Branche, Umsatz und Standort zu vervollständigen
  • Tech-Stack und Wachstumssignale für die Priorisierung zu ergänzen
  • Firmen mit Handelsregisterdaten (Rechtsform, Gründung, Geschäftsführung) anzureichern

Fair-Use-Richtlinie: Dieser Endpunkt unterliegt unserer Fair-Use-Richtlinie für die Suche.

POST https://api.hiwalter.de/api/v1/tools/enrich_companies

Übergib deinen API-Schlüssel als Bearer-Token im Authorization-Header. Schlüssel folgen dem Format hw_XXXXXXXXXXX.

Der Body wird als application/json gesendet. domains oder list_id ist Pflicht.

ParameterTypBeschreibung
domainsstring[]Domains, bis zu 10.000. Vollständige URLs werden normalisiert.
list_idstringAlternativ: Firmen aus einer gespeicherten Liste.
datasetsenumstring[]Gewünschte Datenblöcke. firmographics (Standard): Name, Branche, Größe, Umsatz, Standort, Beschreibung. register: Handelsregister (Rechtsform, Registernummer, Gründung, Geschäftsführer). tech_stack: erkannte Tools. growth: Footprint-Verlauf der letzten 5 Quartale. status: aktiv, geschlossen oder weitergeleitet. socials: LinkedIn, Xing und weitere Profile.
Terminal window
curl --request POST \
--url https://api.hiwalter.de/api/v1/tools/enrich_companies \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"domains": [
"mueller-maschinenbau.de",
"pack-tech.de"
],
"datasets": [
"firmographics",
"register",
"tech_stack",
"growth"
]
}
'
{
"results": [
{
"domain": "mueller-maschinenbau.de",
"name": "Müller Maschinenbau GmbH",
"industry": "Manufacturing",
"employees": "51-200",
"revenue_range": "€10M - €20M",
"address": {
"street": "Industriestraße 12",
"zip": "33602",
"city": "Bielefeld",
"country": "Germany"
},
"register": {
"legal_form": "GmbH",
"court": "Amtsgericht Bielefeld",
"number": "HRB 12345",
"founded": "1998-04-01",
"managing_directors": [
"Anna Becker"
]
},
"tech_stack": [
"hubspot.com",
"personio.de"
],
"growth": {
"trend": "up",
"footprint_by_quarter": [
380,
391,
398,
405,
412
]
},
"status": "active"
}
],
"status": "ok",
"metadata": {
"fair_use": {
"records_remaining_5h": 179999,
"records_reset_5h": "2026-11-02T18:53:16Z",
"records_remaining_1w": 899999,
"records_reset_1w": "2026-11-09T13:53:16Z"
}
}
}
FeldTypBeschreibung
results[].registerobjectHandelsregisterdaten: Rechtsform, Gericht, Registernummer, Gründung, Geschäftsführer.
results[].tech_stackstring[]Erkannte Tools als Anbieter-Domains.
results[].growth.trendstringup, flat oder down über die letzten 5 Quartale.
results[].statusstringactive, closed oder redirected.
metadata.fair_useobjectVerbleibendes Kontingent.