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_emailAuthentifizierung
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. Pro Person sind first_name, last_name und domain Pflicht.
| Parameter | Typ | Beschreibung |
|---|---|---|
people | object[] | Bis zu 500 Personen mit first_name, last_name, domain. |
email_risk | enumstring[] | Erlaubte Risiko-Scores. Standard: ["A", "B"]. |
Beispiel
Section titled “Beispiel”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" } ]}'Antwort
Section titled “Antwort”{ "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" } }}| Feld | Typ | Beschreibung |
|---|---|---|
results[].email | string | Beste gefundene Adresse oder null. |
results[].risk_score | string | Risiko-Score (A-F), siehe Risiko-Scores. |
results[].smtp_valid | boolean | Der Mailserver hat die Adresse bestätigt. |
results[].catch_all | boolean | Die Domain nimmt alle Adressen an, die Zustellung ist daher nicht garantiert. |
results[].pattern | string | Erkanntes E-Mail-Muster der Firma. |