Skip to content

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_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. companies ist Pflicht.

ParameterTypBeschreibung
companiesobject[]Bis zu 10.000 Einträge mit name und optional city, country.
min_confidenceintegerMindest-Konfidenz (50-100, Standard: 70). Treffer darunter kommen ohne Domain zurück.
save_as_liststringSpeichert alle Treffer als Liste.
Terminal window
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
}
'
{
"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"
}
}
}
FeldTypBeschreibung
results[].inputobjectDein Eingabe-Eintrag.
results[].domainstringGefundene Domain oder null.
results[].match_confidenceintegerSicherheit des Treffers (0-100).
matchedintegerAnzahl Treffer.
unmatchedintegerAnzahl ohne Treffer.