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_companiesAuthentifizierung
Section titled “Authentifizierung”Übergib deinen API-Schlüssel als Bearer-Token im Authorization-Header. Schlüssel folgen dem Format hw_XXXXXXXXXXX.
Anfrage
Section titled “Anfrage”Der Body wird als application/json gesendet. domains oder list_id ist Pflicht.
| Parameter | Typ | Beschreibung |
|---|---|---|
domains | string[] | Domains, bis zu 10.000. Vollständige URLs werden normalisiert. |
list_id | string | Alternativ: Firmen aus einer gespeicherten Liste. |
datasets | enumstring[] | 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. |
Beispiel
Section titled “Beispiel”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" ]}'Antwort
Section titled “Antwort”{ "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" } }}| Feld | Typ | Beschreibung |
|---|---|---|
results[].register | object | Handelsregisterdaten: Rechtsform, Gericht, Registernummer, Gründung, Geschäftsführer. |
results[].tech_stack | string[] | Erkannte Tools als Anbieter-Domains. |
results[].growth.trend | string | up, flat oder down über die letzten 5 Quartale. |
results[].status | string | active, closed oder redirected. |
metadata.fair_use | object | Verbleibendes Kontingent. |