Saltar al contenido principal
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
    }
  }'

{
  "message": "Bulk search operating",
  "id": "0cf517bc-16e8-45bc-b967-ab9116b3c804",
  "credits_used": 3,
  "estimated_duration": 1
}
POST 
https://api.enrow.io/email/find/bulk
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 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

​
searches
array of objects
requerido
Cargas útiles de búsqueda para las que se deben encontrar los correos correspondientes.
​
custom
object
Parámetros personalizados que se devolverán en la respuesta GET y en la notificación del webhook.
​
settings
object
Ajustes relativos a toda la búsqueda masiva.

​
Respuesta

​
201 — Búsqueda masiva iniciada

​
message
string
Mensaje de confirmación
​
id
string
Identificador único de este lote. Úsalo para recuperar los resultados a través del endpoint GET.
​
credits_used
number
Total de créditos consumidos. Consulta Créditos y facturación para conocer los costos por endpoint.
​
estimated_duration
number
Tiempo estimado de procesamiento en minutos (no garantizado)

​
Respuestas de error

CodeMessage
400Missing payload
400Missing searches payload
400Too many searches. Limit is currently at 5000 per batch.
400Error while parsing payload
401No apikey found in the x-api-key headers
401This apikey is not valid
402Insufficient 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
    }
  }'

{
  "message": "Bulk search operating",
  "id": "0cf517bc-16e8-45bc-b967-ab9116b3c804",
  "credits_used": 3,
  "estimated_duration": 1
}

​
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.