Business-E-Mail per Name suchen

Der Business Email Finder findet die gültige Arbeits-E-Mail-Adresse einer Person allein aus deren Namen und der Firmendomain.

Er führt eine LinkedIn-Profilsuche und einen E-Mail-Lookup in einem einzigen Call aus und liefert die E-Mail-Adresse zusammen mit der passenden LinkedIn-Profil-URL zurück. Übergib entweder einen vollständigen Namen oder separate Felder first_name und last_name und gib die Firma als Domain an, zum Beispiel acme.com. URLs werden automatisch normalisiert, und Credits werden nur berechnet, wenn eine E-Mail gefunden wird.

Nutze diesen Endpunkt, um:

• die Arbeits-E-Mail eines Interessenten vor der Ansprache zu finden
• fehlende E-Mail-Felder in einer Lead-Liste zu ergänzen
• CRM-Datensätze mit verifizierten Kontakt-E-Mails anzureichern

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

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

Anfrage

Übergib deinen API-Key als Bearer-Token im Authorization-Header. Keys haben das Format hw_XXXXXXXXXXX.

Feld	Typ	Erforderlich	Beschreibung
name	string	ja*	Vollständiger Name (z. B. ‘John Smith’), wird automatisch in Vor- und Nachname zerlegt.
first_name	string	nein	Vorname (wird verwendet, wenn name nicht angegeben ist).
last_name	string	nein	Nachname (wird verwendet, wenn name nicht angegeben ist).
company	string	ja**	Firmendomain (z. B. ‘acme.com’) oder URL (z. B. ‘https://acme.com’), wird auf die Domain normalisiert.
company_domain	string	ja**	Alias für company, Firmendomain oder URL.

*Entweder name oder die Kombination aus first_name und last_name. **Entweder company oder company_domain.

Beispiel

curl --request POST \
  --url https://api.hiwalter.de/api/v1/tools/search_business_email_by_name \
  --header 'Authorization: Bearer DEIN_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "John Smith",
    "company": "acme.com"
  }'

Antwort

{
  "results": {
    "email": "john.smith@acme.com",
    "risk_score": "A",
    "linkedin_url": "https://linkedin.com/in/john-smith-123"
  },
  "status": "ok",
  "metadata": {
    "fair_use": {
      "records_remaining_5h": 179999,
      "records_reset_5h": "2026-07-15T18:53:16Z",
      "records_remaining_1w": 899999,
      "records_reset_1w": "2026-07-22T13:53:16Z"
    }
  }
}

Feld	Typ	Beschreibung
results.email	string	Gefundene Arbeits-E-Mail-Adresse
results.risk_score	string	Risiko-Score der E-Mail (A bis F)
results.linkedin_url	string	Passende LinkedIn-Profil-URL
status	string	Status der Anfrage (z. B. ok)
metadata.fair_use	object	Verbleibende Kontingente und Reset-Zeitpunkte für die Fair-Use-Fenster (5 Stunden und 1 Woche)

Wird kein Treffer gefunden, ist die Antwort leer und es werden keine Credits berechnet.