Skip to main content
POST
POST
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). La ricerca richiede uno dei seguenti elementi: Se sono presenti entrambi, la ricerca si basa sul nome e sull’azienda.
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

string
Il nome completo della persona per cui trovare l’emailNota: Obbligatorio nelle ricerche per nome e azienda, non in quelle a partire da linkedin_url.
string
Il dominio dell’azienda, sono accettati più formati ("dundermifflin.com", "https://www.dundermifflin.com"…)Nota: Nelle ricerche per nome e azienda è richiesto almeno uno tra company_domain o company_name.
string
Il nome dell’azienda ("Apple", "Air France", …)Nota: Nelle ricerche per nome e azienda è richiesto almeno uno tra company_domain o company_name.
string
L’URL del profilo LinkedIn della persona ("https://www.linkedin.com/in/dwight-schrute"), per cercare a partire dal profilo invece che da un nome e un’azienda. Consulta Ricerca a partire da un URL di profilo LinkedIn.Nota: Viene usato solo se la richiesta non è una ricerca completa per nome e azienda. In presenza di un fullname e di un’azienda, linkedin_url viene ignorato.
object
Parametri personalizzati che verranno restituiti nella risposta GET e nella notifica webhook.
object
Un insieme di impostazioni relative a questa ricerca

Risposta

200 — Ricerca avviata

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

Risposte di errore

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.

Ricerca a partire da un URL di profilo LinkedIn

Invia l’URL del profilo LinkedIn di una persona in linkedin_url al posto di un nome completo e di un’azienda. Enrow legge il profilo, individua l’azienda attuale della persona, poi trova e verifica la sua email professionale presso quell’azienda. La ricerca funziona come qualsiasi altra ricerca singola: la risposta 200 ti restituisce il suo id e il risultato arriva tramite l’endpoint GET o il tuo webhook. custom e settings funzionano allo stesso modo.
La ricerca a partire dall’URL di un profilo LinkedIn funziona solo per le ricerche singole e potrebbe non essere disponibile su tutti gli account. Se il tuo account non ne dispone, una richiesta con il solo linkedin_url riceve il consueto errore di validazione, ad esempio missing fullname. Contattaci all’indirizzo api@enrow.io se ti serve.

Quando la ricerca usa il profilo?

La ricerca parte dal profilo quando linkedin_url è presente e la richiesta non è una ricerca completa per nome e azienda:
  • fullname manca, è vuoto o ha un solo carattere, oppure
  • non è indicato né company_domain né company_name.
Una richiesta con un fullname e un’azienda resta una ricerca per nome e azienda, anche con un linkedin_url. Quando la ricerca parte dal profilo, il nome e l’azienda provengono dal profilo: eventuali fullname, company_domain o company_name inviati insieme vengono ignorati.

Quali URL sono accettati?

Qualsiasi altro valore viene rifiutato con un 400 e il messaggio invalid linkedin_url format: una pagina aziendale (linkedin.com/company/...), un link breve lnkd.in, una pagina esterna a linkedin.com o il solo nome del profilo senza l’URL.

Come sceglie Enrow l’azienda?

Enrow cerca l’email presso l’azienda attuale della persona, così come appare sul profilo. Se ci sono più posizioni attuali, prende la prima dell’elenco. Le voci che non indicano un datore di lavoro, come lavoratore autonomo, freelance o studente, vengono ignorate. Se il profilo non ha una posizione attuale presso un datore di lavoro, la ricerca termina con no_current_company.

Quanto costa?

L’avvio della ricerca consuma 1 credito, come per qualsiasi ricerca (credits_used: 1 nella risposta). Al termine, la differenza viene rimborsata: la ricerca costa 1 credito se viene trovata un’email, 0,25 crediti se non ne viene trovata nessuna e nulla se fallisce a causa di un problema da parte nostra. Il risultato indica il motivo in linkedin_status e il costo finale in credits_used. Consulta Crediti e fatturazione.

Esempio

La risposta è la stessa di una ricerca per nome e azienda:

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.