Skip to content

E-Mail finden (find_email)

Du hast Namen aus einer anderen Quelle, z. B. aus dem Impressum, von LinkedIn oder einer Messe, aber keine E-Mail? find_email leitet aus Name und Domain die wahrscheinlichen Adressen ab, prüft sie per SMTP und gibt die beste mit Risiko-Score zurück.

Einzelne Personen bekommen die Antwort direkt. Batches bis 500 Personen laufen asynchron über Task-Status abrufen.

Nutze diesen Endpunkt, um:

  • Geschäftsführer aus dem Impressum oder Handelsregister anschreibbar zu machen
  • Kontakte zu ergänzen, die nicht im HiWalter-Index sind

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

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

Ü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. Pro Person sind first_name, last_name und domain Pflicht.

ParameterTypBeschreibung
peopleobject[]Bis zu 500 Personen mit first_name, last_name, domain.
email_riskenumstring[]Erlaubte Risiko-Scores. Standard: ["A", "B"].
Terminal window
curl --request POST \
--url https://api.hiwalter.de/api/v1/tools/find_email \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"people": [
{
"first_name": "Anna",
"last_name": "Becker",
"domain": "mueller-maschinenbau.de"
}
]
}
'
{
"results": [
{
"input": {
"first_name": "Anna",
"last_name": "Becker",
"domain": "mueller-maschinenbau.de"
},
"email": "a.becker@mueller-maschinenbau.de",
"risk_score": "A",
"smtp_valid": true,
"catch_all": false,
"pattern": "{first_initial}.{last}"
}
],
"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[].emailstringBeste gefundene Adresse oder null.
results[].risk_scorestringRisiko-Score (A-F), siehe Risiko-Scores.
results[].smtp_validbooleanDer Mailserver hat die Adresse bestätigt.
results[].catch_allbooleanDie Domain nimmt alle Adressen an, die Zustellung ist daher nicht garantiert.
results[].patternstringErkanntes E-Mail-Muster der Firma.