Saltar para o conteúdo 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
Execute várias buscas de email em uma única requisição. Até 5.000 buscas por lote. Autentique cada requisição com sua chave de API no cabeçalho x-api-key. Para encontrar um único email, use o endpoint Encontrar Email.
A Enrow realiza verificações determinísticas que verificam até mesmo emails catch-all. Nenhum debouncer necessário.

​
Corpo da Requisição

​
searches
array of objects
obrigatório
Payloads de busca para os quais encontrar os emails correspondentes.
​
custom
object
Parâmetros personalizados que serão retornados na resposta GET e na notificação via webhook.
​
settings
object
Configurações relativas a toda a busca em massa.

​
Resposta

​
201 — Busca em massa iniciada

​
message
string
Mensagem de confirmação
​
id
string
Identificador único deste lote. Use-o para recuperar os resultados por meio do endpoint GET.
​
credits_used
number
Total de créditos consumidos. Consulte Créditos e cobrança para os custos por endpoint.
​
estimated_duration
number
Tempo estimado de processamento em minutos (não garantido)

​
Respostas de Erro

CódigoMensagem
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
Em caso de créditos insuficientes, o endpoint em massa retorna HTTP 402 com um corpo no formato { "message": "..." }. Consulte Tratamento de erros para a lista completa de códigos de status e formatos de resposta.
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 passos

Obter resultados em massa

Recupere os emails encontrados usando o id do lote.

Encontrar um único email

Execute uma única busca de email a partir de um nome e uma empresa.

Webhooks

Seja notificado automaticamente quando um lote for concluído.

Créditos e cobrança

Veja como os créditos são consumidos em cada endpoint.