curl --request POST \
--url https://api.enrow.io/email/find/bulk \
--header 'Content-Type: application/json' \
--header 'x-api-key: YOUR_API_KEY' \
--data '{
"searches": [
{
"fullname": "Dwight Schrute",
"company_domain": "dundermifflin.com",
"custom": "lead_001"
},
{
"fullname": "Jim Halpert",
"company_domain": "dundermifflin.com",
"custom": "lead_002"
},
{
"fullname": "Ryan Howard",
"company_domain": "dundermifflin.com",
"custom": "lead_003"
}
],
"settings": {
"webhook": "https://your-app.com/webhooks/enrow",
"retrieve_gender": true
}
}'
const response = await fetch('https://api.enrow.io/email/find/bulk', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'x-api-key': process.env.ENROW_API_KEY
},
body: JSON.stringify({
searches: [
{ fullname: 'Dwight Schrute', company_domain: 'dundermifflin.com', custom: 'lead_001' },
{ fullname: 'Jim Halpert', company_domain: 'dundermifflin.com', custom: 'lead_002' },
{ fullname: 'Ryan Howard', company_domain: 'dundermifflin.com', custom: 'lead_003' }
],
settings: {
webhook: 'https://your-app.com/webhooks/enrow',
retrieve_gender: true
}
})
});
const data = await response.json();
console.log(`Batch ID: ${data.id}`);
import requests
import os
url = "https://api.enrow.io/email/find/bulk"
headers = {
"Content-Type": "application/json",
"x-api-key": os.getenv("ENROW_API_KEY")
}
payload = {
"searches": [
{"fullname": "Dwight Schrute", "company_domain": "dundermifflin.com", "custom": "lead_001"},
{"fullname": "Jim Halpert", "company_domain": "dundermifflin.com", "custom": "lead_002"},
{"fullname": "Ryan Howard", "company_domain": "dundermifflin.com", "custom": "lead_003"}
],
"settings": {
"webhook": "https://your-app.com/webhooks/enrow",
"retrieve_gender": True
}
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())
{
"message": "Bulk search operating",
"id": "0cf517bc-16e8-45bc-b967-ab9116b3c804",
"credits_used": 3,
"estimated_duration": 1
}
{
"message": "..."
}
Email Finder
Trova email in blocco
Trova indirizzi email professionali in blocco a partire da nomi e aziende — fino a 5.000 ricerche per batch con Enrow Email Finder
POST
/
email
/
find
/
bulk
curl --request POST \
--url https://api.enrow.io/email/find/bulk \
--header 'Content-Type: application/json' \
--header 'x-api-key: YOUR_API_KEY' \
--data '{
"searches": [
{
"fullname": "Dwight Schrute",
"company_domain": "dundermifflin.com",
"custom": "lead_001"
},
{
"fullname": "Jim Halpert",
"company_domain": "dundermifflin.com",
"custom": "lead_002"
},
{
"fullname": "Ryan Howard",
"company_domain": "dundermifflin.com",
"custom": "lead_003"
}
],
"settings": {
"webhook": "https://your-app.com/webhooks/enrow",
"retrieve_gender": true
}
}'
const response = await fetch('https://api.enrow.io/email/find/bulk', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'x-api-key': process.env.ENROW_API_KEY
},
body: JSON.stringify({
searches: [
{ fullname: 'Dwight Schrute', company_domain: 'dundermifflin.com', custom: 'lead_001' },
{ fullname: 'Jim Halpert', company_domain: 'dundermifflin.com', custom: 'lead_002' },
{ fullname: 'Ryan Howard', company_domain: 'dundermifflin.com', custom: 'lead_003' }
],
settings: {
webhook: 'https://your-app.com/webhooks/enrow',
retrieve_gender: true
}
})
});
const data = await response.json();
console.log(`Batch ID: ${data.id}`);
import requests
import os
url = "https://api.enrow.io/email/find/bulk"
headers = {
"Content-Type": "application/json",
"x-api-key": os.getenv("ENROW_API_KEY")
}
payload = {
"searches": [
{"fullname": "Dwight Schrute", "company_domain": "dundermifflin.com", "custom": "lead_001"},
{"fullname": "Jim Halpert", "company_domain": "dundermifflin.com", "custom": "lead_002"},
{"fullname": "Ryan Howard", "company_domain": "dundermifflin.com", "custom": "lead_003"}
],
"settings": {
"webhook": "https://your-app.com/webhooks/enrow",
"retrieve_gender": True
}
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())
{
"message": "Bulk search operating",
"id": "0cf517bc-16e8-45bc-b967-ab9116b3c804",
"credits_used": 3,
"estimated_duration": 1
}
{
"message": "..."
}
POST
Esegui più ricerche di email in un’unica richiesta. Fino a 5.000 ricerche per batch. Autentica ogni richiesta con la tua chiave API nell’header
https://api.enrow.io/email/find/bulk
x-api-key. Per trovare una singola email, usa invece l’endpoint Find Single Email.
Enrow esegue verifiche deterministiche che verificano anche le email catch-all. Nessun debouncer necessario.
Corpo della richiesta
array of objects
obbligatorio
Payload di ricerca per i quali trovare le email corrispondenti.
Mostra proprietà dell'oggetto search
Mostra proprietà dell'oggetto search
string
obbligatorio
Il nome completo dell’utente
string
Il dominio dell’azienda o l’URL del sito web. È richiesto
company_domain oppure company_name.string
Il nome dell’azienda dell’utente. È richiesto
company_domain oppure company_name.string | object
Un valore personalizzato che puoi utilizzare per fare riferimento a un ID interno (ad esempio). Sarà presente nei risultati.
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
Impostazioni relative all’intera ricerca in blocco.
Mostra proprietà di settings
Mostra proprietà di settings
string
predefinito:"US"
Un codice di 2 caratteri che rappresenta il paese delle ricerche (codice ISO 3166 Alpha-2). Rilevante quando si utilizza
company_name.string
Un URL che verrà notificato tramite una richiesta HTTP POST una volta terminata la ricerca in blocco. Vedi Come funzionano i webhook.
boolean
predefinito:"false"
Ottieni il genere associato quando viene trovata un’email.
boolean
predefinito:"false"
Ottieni le informazioni aziendali associate. Efficace solo quando
country_code è FR.Risposta
201 — Ricerca in blocco avviata
string
Messaggio di conferma
string
Identificatore univoco per questo batch. Usalo per recuperare i risultati tramite l’endpoint GET.
number
Crediti totali consumati. Vedi Crediti e fatturazione per i costi per endpoint.
number
Tempo di elaborazione stimato in minuti (non garantito)
Risposte di errore
| Code | Message |
|---|---|
| 400 | Missing payload |
| 400 | Missing searches payload |
| 400 | Too many searches. Limit is currently at 5000 per batch. |
| 400 | Error while parsing payload |
| 401 | No apikey found in the x-api-key headers |
| 401 | This apikey is not valid |
| 402 | Insufficient credits |
In caso di crediti insufficienti, l’endpoint bulk restituisce HTTP 402 con un corpo nella forma
{ "message": "..." }. Vedi 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/bulk \
--header 'Content-Type: application/json' \
--header 'x-api-key: YOUR_API_KEY' \
--data '{
"searches": [
{
"fullname": "Dwight Schrute",
"company_domain": "dundermifflin.com",
"custom": "lead_001"
},
{
"fullname": "Jim Halpert",
"company_domain": "dundermifflin.com",
"custom": "lead_002"
},
{
"fullname": "Ryan Howard",
"company_domain": "dundermifflin.com",
"custom": "lead_003"
}
],
"settings": {
"webhook": "https://your-app.com/webhooks/enrow",
"retrieve_gender": true
}
}'
const response = await fetch('https://api.enrow.io/email/find/bulk', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'x-api-key': process.env.ENROW_API_KEY
},
body: JSON.stringify({
searches: [
{ fullname: 'Dwight Schrute', company_domain: 'dundermifflin.com', custom: 'lead_001' },
{ fullname: 'Jim Halpert', company_domain: 'dundermifflin.com', custom: 'lead_002' },
{ fullname: 'Ryan Howard', company_domain: 'dundermifflin.com', custom: 'lead_003' }
],
settings: {
webhook: 'https://your-app.com/webhooks/enrow',
retrieve_gender: true
}
})
});
const data = await response.json();
console.log(`Batch ID: ${data.id}`);
import requests
import os
url = "https://api.enrow.io/email/find/bulk"
headers = {
"Content-Type": "application/json",
"x-api-key": os.getenv("ENROW_API_KEY")
}
payload = {
"searches": [
{"fullname": "Dwight Schrute", "company_domain": "dundermifflin.com", "custom": "lead_001"},
{"fullname": "Jim Halpert", "company_domain": "dundermifflin.com", "custom": "lead_002"},
{"fullname": "Ryan Howard", "company_domain": "dundermifflin.com", "custom": "lead_003"}
],
"settings": {
"webhook": "https://your-app.com/webhooks/enrow",
"retrieve_gender": True
}
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())
{
"message": "Bulk search operating",
"id": "0cf517bc-16e8-45bc-b967-ab9116b3c804",
"credits_used": 3,
"estimated_duration": 1
}
{
"message": "..."
}
Prossimi passi
Ottieni i risultati in blocco
Recupera le email trovate usando l’
id del batch.Trova una singola email
Esegui una singola ricerca di email a partire da un nome e un’azienda.
Webhook
Ricevi notifiche automatiche al completamento di un batch.
Crediti e fatturazione
Scopri come vengono consumati i crediti per ciascun endpoint.
Questa pagina è stata utile?

