Zum Hauptinhalt springen
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
    }
  }'

{
  "message": "Single search operating",
  "id": "0cf517bc-16e8-45bc-b967-ab9116b3c804",
  "credits_used": 1
}
POST 
https://api.enrow.io/email/find/single
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).
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

​
fullname
string
erforderlich
Der vollständige Name der Person, für die die E-Mail gefunden werden soll
​
company_domain
string
Die Domain des Unternehmens, mehrere Formate werden akzeptiert ("dundermifflin.com", "https://www.dundermifflin.com"…)Hinweis: Entweder company_domain oder company_name ist erforderlich.
​
company_name
string
Der Name des Unternehmens ("Apple", "Air France", …)Hinweis: Entweder company_domain oder company_name ist erforderlich.
​
custom
object
Benutzerdefinierte Parameter, die in der GET-Antwort und in der Webhook-Benachrichtigung zurückgegeben werden.
​
settings
object
Eine Reihe von Einstellungen für diese Suche

​
Response

​
200 — Suche gestartet

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

​
Error Responses

CodeMessage
400invalid JSON input
400both company_domain and company_name are absent, input payload needs at least one of them
400missing fullname
401No apikey found in the x-api-key headers
401This apikey is not valid
402Insufficient credits
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. 
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
    }
  }'

{
  "message": "Single search operating",
  "id": "0cf517bc-16e8-45bc-b967-ab9116b3c804",
  "credits_used": 1
}

​
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.