Firmennamen zu Domains (match_companies)
Viele Listen haben nur Firmennamen: Messekataloge, Verbandsverzeichnisse, alte CRM-Exporte. match_companies findet zu jedem Namen die passende Domain, damit du die Firma danach anreichern oder Kontakte ziehen kannst.
Jeder Treffer hat eine match_confidence. Bei Namensgleichheit (z. B. “Becker GmbH”) helfen city und country.
Bis 100 Namen kommt die Antwort direkt. Größere Listen laufen asynchron über Task-Status abrufen.
Nutze diesen Endpunkt, um:
- Messe- und Ausstellerlisten in Domains zu übersetzen
- CRM-Einträge ohne Website zu vervollständigen
Fair-Use-Richtlinie: Dieser Endpunkt unterliegt unserer Fair-Use-Richtlinie für die Suche.
POST https://api.hiwalter.de/api/v1/tools/match_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. companies ist Pflicht.
| Parameter | Typ | Beschreibung |
|---|---|---|
companies | object[] | Bis zu 10.000 Einträge mit name und optional city, country. |
min_confidence | integer | Mindest-Konfidenz (50-100, Standard: 70). Treffer darunter kommen ohne Domain zurück. |
save_as_list | string | Speichert alle Treffer als Liste. |
Beispiel
Section titled “Beispiel”curl --request POST \ --url https://api.hiwalter.de/api/v1/tools/match_companies \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "companies": [ { "name": "Müller Maschinenbau", "city": "Bielefeld" }, { "name": "Pack-Tech", "country": "Germany" } ], "min_confidence": 75}'Antwort
Section titled “Antwort”{ "results": [ { "input": { "name": "Müller Maschinenbau", "city": "Bielefeld" }, "domain": "mueller-maschinenbau.de", "name": "Müller Maschinenbau GmbH", "match_confidence": 94 } ], "matched": 2, "unmatched": 0, "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[].input | object | Dein Eingabe-Eintrag. |
results[].domain | string | Gefundene Domain oder null. |
results[].match_confidence | integer | Sicherheit des Treffers (0-100). |
matched | integer | Anzahl Treffer. |
unmatched | integer | Anzahl ohne Treffer. |