Skip to main content
POST
POST
Führen Sie eine einzelne E-Mail-Suche durch, um eine berufliche E-Mail-Adresse zu finden. Authentifizieren Sie jede Anfrage mit Ihrem API-Schlüssel im x-api-key-Header. Für Batch-Operationen verwenden Sie den Endpunkt E-Mails finden (bis zu 5.000 Suchen pro Batch). Die Suche benötigt entweder:
  • Einen vollständigen Namen und ein Unternehmen: fullname + (company_domain oder company_name)
  • Die URL des LinkedIn-Profils einer Person in linkedin_url (siehe Suche anhand einer LinkedIn-Profil-URL)
Ist beides angegeben, läuft die Suche über den Namen und das Unternehmen.
Enrow führt deterministische Verifizierungen durch, die selbst Catch-all-E-Mails verifizieren. Das bedeutet, dass die gefundenen E-Mails danach nicht mehr durch einen Debouncer geleitet werden müssen.

Request Body

string
Der vollständige Name der Person, für die die E-Mail gefunden werden sollHinweis: Erforderlich für eine Suche anhand von Name und Unternehmen, nicht für eine Suche über linkedin_url.
string
Die Domain des Unternehmens, mehrere Formate werden akzeptiert ("dundermifflin.com", "https://www.dundermifflin.com"…)Hinweis: Für eine Suche anhand von Name und Unternehmen ist entweder company_domain oder company_name erforderlich.
string
Der Name des Unternehmens ("Apple", "Air France", …)Hinweis: Für eine Suche anhand von Name und Unternehmen ist entweder company_domain oder company_name erforderlich.
string
Die LinkedIn-Profil-URL der Person ("https://www.linkedin.com/in/dwight-schrute"), um anhand des Profils statt anhand eines Namens und eines Unternehmens zu suchen. Siehe Suche anhand einer LinkedIn-Profil-URL.Hinweis: Wird nur verwendet, wenn die Anfrage keine vollständige Suche anhand von Name und Unternehmen ist. Mit einem fullname und einem Unternehmen wird linkedin_url ignoriert.
object
Benutzerdefinierte Parameter, die in der GET-Antwort und in der Webhook-Benachrichtigung zurückgegeben werden.
object
Eine Reihe von Einstellungen für diese Suche

Response

200 — Suche gestartet

string
Bestätigungsnachricht
string
Eindeutige Kennung für diese Suche. Verwenden Sie sie, um Ergebnisse über den GET-Endpunkt abzurufen.
number
Anzahl der verbrauchten Credits. Siehe Credits & Abrechnung für die Kosten pro Endpunkt.

Error Responses

Antworten bei unzureichendem Guthaben (402) auf Einzel-Endpunkten geben { "reason": "...", "success": false } zurück; alle anderen Fehler geben { "message": "..." } zurück.
Siehe Fehlerbehandlung für die vollständige Liste der Statuscodes und Antwortformate.

Suche anhand einer LinkedIn-Profil-URL

Senden Sie statt eines vollständigen Namens und eines Unternehmens die LinkedIn-Profil-URL einer Person in linkedin_url. Enrow liest das Profil, ermittelt das aktuelle Unternehmen der Person und findet und verifiziert dort ihre berufliche E-Mail-Adresse. Die Suche läuft wie jede andere Einzelsuche: Die 200-Antwort liefert ihre id, und das Ergebnis erhalten Sie über den GET-Endpunkt oder Ihren Webhook. custom und settings funktionieren genauso.
Die Suche anhand einer LinkedIn-Profil-URL funktioniert nur bei Einzelsuchen und ist möglicherweise nicht für jedes Konto verfügbar. Hat Ihr Konto keinen Zugriff darauf, erhält eine Anfrage, die nur eine linkedin_url enthält, den üblichen Validierungsfehler, zum Beispiel missing fullname. Wenden Sie sich an api@enrow.io, wenn Sie die Funktion benötigen.

Wann nutzt die Suche das Profil?

Die Suche läuft über das Profil, wenn linkedin_url angegeben ist und die Anfrage keine vollständige Suche anhand von Name und Unternehmen ist:
  • fullname fehlt, ist leer oder besteht aus nur einem Zeichen, oder
  • weder company_domain noch company_name ist angegeben.
Eine Anfrage mit einem fullname und einem Unternehmen bleibt eine Suche anhand von Name und Unternehmen, auch mit einer linkedin_url. Läuft die Suche über das Profil, stammen Name und Unternehmen aus dem Profil: Ein zusätzlich gesendeter fullname, company_domain oder company_name wird ignoriert.

Welche URLs werden akzeptiert?

Jeder andere Wert wird mit einem 400 und der Meldung invalid linkedin_url format abgelehnt: eine Unternehmensseite (linkedin.com/company/...), ein Kurzlink lnkd.in, eine Seite außerhalb von linkedin.com oder ein Profilname ohne die URL.

Wie wählt Enrow das Unternehmen aus?

Enrow sucht die E-Mail beim aktuellen Unternehmen der Person, wie es im Profil angegeben ist. Gibt es mehrere aktuelle Positionen, nimmt Enrow die zuerst aufgeführte. Einträge, die keinen Arbeitgeber bezeichnen, etwa Selbstständigkeit, freiberufliche Tätigkeit oder Studium, werden übersprungen. Ein Profil ohne aktuelle Position bei einem Arbeitgeber beendet die Suche mit no_current_company.

Was kostet die Suche?

Der Start der Suche verbraucht 1 Credit, wie bei jeder Suche (credits_used: 1 in der Antwort). Sobald die Suche abgeschlossen ist, wird die Differenz erstattet: Die Suche kostet 1 Credit, wenn eine E-Mail gefunden wird, 0,25 Credit, wenn keine gefunden wird, und nichts, wenn sie wegen eines Problems auf unserer Seite fehlschlägt. Das Ergebnis nennt den Grund in linkedin_status und die endgültigen Kosten in credits_used. Siehe Credits & Abrechnung.

Beispiel

Die Antwort ist dieselbe wie bei einer Suche anhand von Name und Unternehmen:

Nächste Schritte

Ergebnis abrufen

Rufen Sie die gefundene E-Mail anhand der Such-id ab.

E-Mails per Batch finden

Führen Sie bis zu 5.000 E-Mail-Suchen in einer einzigen Anfrage durch.

Authentifizierung

So übergeben Sie Ihren API-Schlüssel im x-api-key-Header.

Webhooks

Werden Sie automatisch benachrichtigt, wenn eine Suche abgeschlossen ist.