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
Buscar correos
Encuentra direcciones de correo profesionales de forma masiva a partir de nombres y empresas: hasta 5000 búsquedas por lote 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
Ejecuta varias búsquedas de correo en una sola solicitud. Hasta 5000 búsquedas por lote. Autentica cada solicitud con tu clave de API en el encabezado
https://api.enrow.io/email/find/bulk
x-api-key. Para encontrar un solo correo, usa el endpoint Find Single Email.
Enrow realiza verificaciones deterministas que verifican incluso los correos catch-all. No se necesita ningún debouncer.
Cuerpo de la solicitud
array of objects
requerido
Cargas útiles de búsqueda para las que se deben encontrar los correos correspondientes.
Mostrar propiedades del objeto search
Mostrar propiedades del objeto search
string
requerido
El nombre completo del usuario
string
El dominio de la empresa o la URL del sitio web. Se requiere
company_domain o company_name.string
El nombre de la empresa del usuario. Se requiere
company_domain o company_name.string | object
Un valor personalizado que puedes usar para referenciar un ID interno (por ejemplo). Estará presente en los resultados.
object
Parámetros personalizados que se devolverán en la respuesta GET y en la notificación del webhook.
Mostrar objeto custom
Mostrar objeto custom
string
predeterminado:"your_custom_property"
Tus datos personalizados
object
Ajustes relativos a toda la búsqueda masiva.
Mostrar propiedades de settings
Mostrar propiedades de settings
string
predeterminado:"US"
Un código de 2 caracteres que representa el país de las búsquedas (código ISO 3166 Alpha-2). Relevante cuando se usa
company_name.string
Una URL que será notificada mediante una solicitud HTTP POST una vez que finalice la búsqueda masiva. Consulta How Webhooks Work.
boolean
predeterminado:"false"
Obtén el género asociado cuando se encuentra un correo.
boolean
predeterminado:"false"
Obtén la información asociada de la empresa. Solo es efectivo cuando
country_code es FR.Respuesta
201 — Búsqueda masiva iniciada
string
Mensaje de confirmación
string
Identificador único de este lote. Úsalo para recuperar los resultados a través del endpoint GET.
number
Total de créditos consumidos. Consulta Créditos y facturación para conocer los costos por endpoint.
number
Tiempo estimado de procesamiento en minutos (no garantizado)
Respuestas de error
| 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 |
En caso de créditos insuficientes, el endpoint de búsqueda masiva devuelve HTTP 402 con un cuerpo de la forma
{ "message": "..." }. Consulta Manejo de errores para ver la lista completa de códigos de estado y formatos de respuesta.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": "..."
}
Próximos pasos
Obtener resultados masivos
Recupera los correos encontrados usando el
id del lote.Buscar un solo correo
Ejecuta una sola búsqueda de correo a partir de un nombre y una empresa.
Webhooks
Recibe una notificación automática cuando un lote se completa.
Créditos y facturación
Consulta cómo se consumen los créditos en cada endpoint.
¿Esta página le ayudó?

