curl --request POST \
--url https://api.enrow.io/email/find/single \
--header 'Content-Type: application/json' \
--header 'x-api-key: YOUR_API_KEY' \
--data '{
"fullname": "Dwight Schrute",
"company_domain": "dundermifflin.com",
"settings": {
"retrieve_gender": true
}
}'
const response = await fetch('https://api.enrow.io/email/find/single', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'x-api-key': process.env.ENROW_API_KEY
},
body: JSON.stringify({
fullname: 'Dwight Schrute',
company_domain: 'dundermifflin.com',
settings: {
retrieve_gender: true
}
})
});
const data = await response.json();
console.log(data.id);
import requests
import os
url = "https://api.enrow.io/email/find/single"
headers = {
"Content-Type": "application/json",
"x-api-key": os.getenv("ENROW_API_KEY")
}
payload = {
"fullname": "Dwight Schrute",
"company_domain": "dundermifflin.com",
"settings": {
"retrieve_gender": True
}
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())
{
"message": "Single search operating",
"id": "0cf517bc-16e8-45bc-b967-ab9116b3c804",
"credits_used": 1
}
{
"message": "..."
}
Email Finder
E-Mail finden
Eine einzelne berufliche E-Mail-Adresse anhand eines vollständigen Namens und einer Unternehmensdomain oder eines Unternehmensnamens finden, alternativ anhand einer LinkedIn-Profil-URL
POST
/
email
/
find
/
single
curl --request POST \
--url https://api.enrow.io/email/find/single \
--header 'Content-Type: application/json' \
--header 'x-api-key: YOUR_API_KEY' \
--data '{
"fullname": "Dwight Schrute",
"company_domain": "dundermifflin.com",
"settings": {
"retrieve_gender": true
}
}'
const response = await fetch('https://api.enrow.io/email/find/single', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'x-api-key': process.env.ENROW_API_KEY
},
body: JSON.stringify({
fullname: 'Dwight Schrute',
company_domain: 'dundermifflin.com',
settings: {
retrieve_gender: true
}
})
});
const data = await response.json();
console.log(data.id);
import requests
import os
url = "https://api.enrow.io/email/find/single"
headers = {
"Content-Type": "application/json",
"x-api-key": os.getenv("ENROW_API_KEY")
}
payload = {
"fullname": "Dwight Schrute",
"company_domain": "dundermifflin.com",
"settings": {
"retrieve_gender": True
}
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())
{
"message": "Single search operating",
"id": "0cf517bc-16e8-45bc-b967-ab9116b3c804",
"credits_used": 1
}
{
"message": "..."
}
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
Siehe Fehlerbehandlung für die vollständige Liste der Statuscodes und Antwortformate.
Jeder andere Wert wird mit einem
Die Antwort ist dieselbe wie bei einer Suche anhand von Name und Unternehmen:
https://api.enrow.io/email/find/single
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_domainodercompany_name) - Die URL des LinkedIn-Profils einer Person in
linkedin_url(siehe Suche anhand einer LinkedIn-Profil-URL)
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.
Anzeigen custom-Objekt
Anzeigen custom-Objekt
string
Standard:"your_custom_property"
Ihre benutzerdefinierten Daten
object
Eine Reihe von Einstellungen für diese Suche
Anzeigen settings-Eigenschaften
Anzeigen settings-Eigenschaften
string
Eine URL, die über eine HTTP-POST-Anfrage benachrichtigt wird, sobald die Einzelsuche abgeschlossen ist. Siehe Wie Webhooks funktionieren.
string
Standard:"US"
Der ISO-3166-Alpha-2-Code des Landes, das mit der Suche zusammenhängt. Relevant bei Verwendung eines Unternehmensnamens — hilft, Homonyme durch die Suche auf einem lokalisierten Google zu unterscheiden.
boolean
Standard:"false"
Ermöglicht es Ihnen, das Geschlecht (
male/female) der Person abzurufen.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
| Code | Message |
|---|---|
| 400 | invalid JSON input |
| 400 | both company_domain and company_name are absent, input payload needs at least one of them |
| 400 | missing fullname |
| 400 | invalid linkedin_url format |
| 400 | LinkedIn email search is suspended for this account |
| 401 | No apikey found in the x-api-key headers |
| 401 | This apikey is not valid |
| 402 | Insufficient credits |
Antworten bei unzureichendem Guthaben (
402) auf Einzel-Endpunkten geben { "reason": "...", "success": false } zurück; alle anderen Fehler geben { "message": "..." } zurück.Suche anhand einer LinkedIn-Profil-URL
Senden Sie statt eines vollständigen Namens und eines Unternehmens die LinkedIn-Profil-URL einer Person inlinkedin_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, wennlinkedin_url angegeben ist und die Anfrage keine vollständige Suche anhand von Name und Unternehmen ist:
fullnamefehlt, ist leer oder besteht aus nur einem Zeichen, oder- weder
company_domainnochcompany_nameist angegeben.
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?
| Format | Beispiel |
|---|---|
| Öffentliche Profil-URL | https://www.linkedin.com/in/dwight-schrute |
Ohne https:// oder www., mit abschließendem Schrägstrich oder Query-Parametern | linkedin.com/in/dwight-schrute/?trk=people-guest |
| Länderspezifische Subdomain | https://fr.linkedin.com/in/dwight-schrute |
| Profil-URL mit Mitglieds-ID | https://www.linkedin.com/in/ACoAAB2xY3ZaBcD |
| Sales-Navigator-URL vom Typ lead oder people | https://www.linkedin.com/sales/lead/ACwAAB2xY3ZaBcD,NAME_SEARCH,a1b2 |
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 mitno_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
curl --request POST \
--url https://api.enrow.io/email/find/single \
--header 'Content-Type: application/json' \
--header 'x-api-key: YOUR_API_KEY' \
--data '{
"linkedin_url": "https://www.linkedin.com/in/dwight-schrute",
"custom": {
"crm_id": "lead_001"
}
}'
const response = await fetch('https://api.enrow.io/email/find/single', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'x-api-key': process.env.ENROW_API_KEY
},
body: JSON.stringify({
linkedin_url: 'https://www.linkedin.com/in/dwight-schrute',
custom: {
crm_id: 'lead_001'
}
})
});
const data = await response.json();
console.log(data.id);
import requests
import os
url = "https://api.enrow.io/email/find/single"
headers = {
"Content-Type": "application/json",
"x-api-key": os.getenv("ENROW_API_KEY")
}
payload = {
"linkedin_url": "https://www.linkedin.com/in/dwight-schrute",
"custom": {
"crm_id": "lead_001"
}
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())
{
"message": "Single search operating",
"id": "0cf517bc-16e8-45bc-b967-ab9116b3c804",
"credits_used": 1
}
curl --request POST \
--url https://api.enrow.io/email/find/single \
--header 'Content-Type: application/json' \
--header 'x-api-key: YOUR_API_KEY' \
--data '{
"fullname": "Dwight Schrute",
"company_domain": "dundermifflin.com",
"settings": {
"retrieve_gender": true
}
}'
const response = await fetch('https://api.enrow.io/email/find/single', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'x-api-key': process.env.ENROW_API_KEY
},
body: JSON.stringify({
fullname: 'Dwight Schrute',
company_domain: 'dundermifflin.com',
settings: {
retrieve_gender: true
}
})
});
const data = await response.json();
console.log(data.id);
import requests
import os
url = "https://api.enrow.io/email/find/single"
headers = {
"Content-Type": "application/json",
"x-api-key": os.getenv("ENROW_API_KEY")
}
payload = {
"fullname": "Dwight Schrute",
"company_domain": "dundermifflin.com",
"settings": {
"retrieve_gender": True
}
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())
{
"message": "Single search operating",
"id": "0cf517bc-16e8-45bc-b967-ab9116b3c804",
"credits_used": 1
}
{
"message": "..."
}
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.
War diese Seite hilfreich?

