Vai al contenuto principale
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
Esegui una singola ricerca email per trovare un indirizzo email professionale. Autentica ogni richiesta con la tua chiave API nell’header x-api-key. Per le operazioni in batch, utilizza l’endpoint Find Bulk Emails (fino a 5.000 ricerche per batch).
Enrow esegue verifiche deterministiche che verificano anche le email catch-all. Ciò significa che non è necessario far passare successivamente le email trovate attraverso un debouncer.

​
Corpo della richiesta

​
fullname
string
obbligatorio
Il nome completo della persona per cui trovare l’email
​
company_domain
string
Il dominio dell’azienda, sono accettati più formati ("dundermifflin.com", "https://www.dundermifflin.com"…)Nota: È richiesto almeno uno tra company_domain o company_name.
​
company_name
string
Il nome dell’azienda ("Apple", "Air France", …)Nota: È richiesto almeno uno tra company_domain o company_name.
​
custom
object
Parametri personalizzati che verranno restituiti nella risposta GET e nella notifica webhook.
​
settings
object
Un insieme di impostazioni relative a questa ricerca

​
Risposta

​
200 — Ricerca avviata

​
message
string
Messaggio di conferma
​
id
string
Identificatore univoco per questa ricerca. Utilizzalo per recuperare i risultati tramite l’endpoint GET.
​
credits_used
number
Numero di crediti consumati. Consulta Crediti e fatturazione per i costi per endpoint.

​
Risposte di errore

CodiceMessaggio
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
Le risposte di credito insufficiente (402) sugli endpoint singoli restituiscono { "reason": "...", "success": false }; tutti gli altri errori restituiscono { "message": "..." }.
Consulta Gestione degli errori per l’elenco completo dei codici di stato e dei formati di risposta. 
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
}

​
Prossimi passi

Ottieni il risultato

Recupera l’email trovata usando l’id della ricerca.

Trova email in blocco

Esegui fino a 5.000 ricerche email in una singola richiesta.

Autenticazione

Come passare la tua chiave API nell’header x-api-key.

Webhook

Ricevi una notifica automatica al completamento di una ricerca.