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
Trova email
Trova un singolo indirizzo email professionale a partire da nome completo e dominio o nome dell’azienda, oppure dall’URL di un profilo LinkedIn
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
Esegui una singola ricerca email per trovare un indirizzo email professionale. Autentica ogni richiesta con la tua chiave API nell’header
Consulta Gestione degli errori per l’elenco completo dei codici di stato e dei formati di risposta.
Qualsiasi altro valore viene rifiutato con un
La risposta è la stessa di una ricerca per nome e azienda:
https://api.enrow.io/email/find/single
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:
- Un nome completo e un’azienda:
fullname+ (company_domainocompany_name) - L’URL del profilo LinkedIn di una persona in
linkedin_url(vedi Ricerca a partire da un URL di profilo LinkedIn)
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.
Mostra oggetto custom
Mostra oggetto custom
string
predefinito:"your_custom_property"
I tuoi dati personalizzati
object
Un insieme di impostazioni relative a questa ricerca
Mostra proprietà settings
Mostra proprietà settings
string
Un URL che verrà notificato tramite una richiesta HTTP POST una volta terminata la singola ricerca. Consulta Come funzionano i webhook.
string
predefinito:"US"
Il codice ISO 3166 Alpha-2 del paese relativo alla ricerca. Rilevante quando si utilizza un nome di azienda — aiuta a disambiguare gli omonimi effettuando la ricerca su Google localizzato.
boolean
predefinito:"false"
Ti consente di ottenere il genere (
male/female) della persona.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
| Codice | Messaggio |
|---|---|
| 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 |
Le risposte di credito insufficiente (
402) sugli endpoint singoli restituiscono { "reason": "...", "success": false }; tutti gli altri errori restituiscono { "message": "..." }.Ricerca a partire da un URL di profilo LinkedIn
Invia l’URL del profilo LinkedIn di una persona inlinkedin_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 quandolinkedin_url è presente e la richiesta non è una ricerca completa per nome e azienda:
fullnamemanca, è vuoto o ha un solo carattere, oppure- non è indicato né
company_domainnécompany_name.
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?
| Formato | Esempio |
|---|---|
| URL del profilo pubblico | https://www.linkedin.com/in/dwight-schrute |
Senza https:// o www., con barra finale o parametri di query | linkedin.com/in/dwight-schrute/?trk=people-guest |
| Sottodominio nazionale | https://fr.linkedin.com/in/dwight-schrute |
| URL del profilo con ID membro | https://www.linkedin.com/in/ACoAAB2xY3ZaBcD |
| URL di Sales Navigator (lead o people) | https://www.linkedin.com/sales/lead/ACwAAB2xY3ZaBcD,NAME_SEARCH,a1b2 |
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 conno_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
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": "..."
}
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.
Questa pagina è stata utile?

