Przejdź do głównej treści
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
Uruchom pojedyncze wyszukiwanie e-maila, aby znaleźć służbowy adres e-mail. Uwierzytelniaj każde żądanie za pomocą swojego klucza API w nagłówku x-api-key. Do operacji wsadowych użyj endpointu Find Bulk Emails (do 5000 wyszukiwań na partię).
Enrow przeprowadza deterministyczne weryfikacje, które weryfikują nawet adresy catch-all. Oznacza to, że nie trzeba później przepuszczać znalezionych adresów przez debouncer.

​
Request Body

​
fullname
string
wymagane
Imię i nazwisko osoby, dla której ma zostać znaleziony e-mail
​
company_domain
string
Domena firmy, akceptowanych jest wiele formatów ("dundermifflin.com", "https://www.dundermifflin.com"…)Uwaga: Wymagany jest co najmniej jeden z parametrów: company_domain lub company_name.
​
company_name
string
Nazwa firmy ("Apple", "Air France", …)Uwaga: Wymagany jest co najmniej jeden z parametrów: company_domain lub company_name.
​
custom
object
Niestandardowe parametry, które zostaną zwrócone w odpowiedzi GET oraz w powiadomieniu webhook.
​
settings
object
Zestaw ustawień związanych z tym wyszukiwaniem

​
Response

​
200 — Wyszukiwanie zainicjowane

​
message
string
Komunikat potwierdzający
​
id
string
Unikalny identyfikator tego wyszukiwania. Użyj go, aby pobrać wyniki za pomocą endpointu GET.
​
credits_used
number
Liczba zużytych kredytów. Zobacz Credits & billing, aby poznać koszty poszczególnych endpointów.

​
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
Odpowiedzi o niewystarczającej liczbie kredytów (402) na endpointach pojedynczych zwracają { "reason": "...", "success": false }; wszystkie pozostałe błędy zwracają { "message": "..." }.
Zobacz Error handling, aby poznać pełną listę kodów statusu i formatów odpowiedzi. 
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
}

​
Następne kroki

Pobierz wynik

Pobierz znaleziony e-mail przy użyciu id wyszukiwania.

Znajdź adresy e-mail zbiorczo

Uruchom do 5000 wyszukiwań e-maili w jednym żądaniu.

Uwierzytelnianie

Jak przekazać klucz API w nagłówku x-api-key.

Webhooki

Otrzymuj automatyczne powiadomienia po zakończeniu wyszukiwania.