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
Encontrar Emails
Encontre endereços de email profissionais em massa a partir de nomes e empresas — até 5.000 buscas por lote com o Email Finder da Enrow
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
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
https://api.enrow.io/email/find/bulk
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
array of objects
obrigatório
Payloads de busca para os quais encontrar os emails correspondentes.
Mostrar propriedades do objeto search
Mostrar propriedades do objeto search
string
obrigatório
O nome completo do usuário
string
O domínio da empresa ou a URL do site. É obrigatório informar
company_domain ou company_name.string
O nome da empresa do usuário. É obrigatório informar
company_domain ou company_name.string | object
Um valor personalizado que você pode usar para referenciar um ID interno (por exemplo). Ele estará presente nos resultados.
object
Parâmetros personalizados que serão retornados na resposta GET e na notificação via webhook.
Mostrar objeto custom
Mostrar objeto custom
string
padrão:"your_custom_property"
Seus dados personalizados
object
Configurações relativas a toda a busca em massa.
Mostrar propriedades de settings
Mostrar propriedades de settings
string
padrão:"US"
Um código de 2 caracteres que representa o país das buscas (código ISO 3166 Alpha-2). Relevante ao usar
company_name.string
Uma URL que será notificada por meio de uma requisição HTTP POST assim que a busca em massa for concluída. Consulte Como Funcionam os Webhooks.
boolean
padrão:"false"
Obtenha o gênero associado quando um email for encontrado.
boolean
padrão:"false"
Obtenha as informações da empresa associada. Efetivo apenas quando
country_code for FR.Resposta
201 — Busca em massa iniciada
string
Mensagem de confirmação
string
Identificador único deste lote. Use-o para recuperar os resultados por meio do endpoint GET.
number
Total de créditos consumidos. Consulte Créditos e cobrança para os custos por endpoint.
number
Tempo estimado de processamento em minutos (não garantido)
Respostas de Erro
| Código | Mensagem |
|---|---|
| 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 |
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
}
}'
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 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.
Esta página foi útil?

