curl --request GET \
--url 'https://api.enrow.io/email/find/bulk?id=3d4cb64e-i64d-41e8-a686-736751004a32' \
--header 'x-api-key: YOUR_API_KEY'
const batchId = '3d4cb64e-i64d-41e8-a686-736751004a32';
const response = await fetch(`https://api.enrow.io/email/find/bulk?id=${batchId}`, {
headers: {
'x-api-key': process.env.ENROW_API_KEY
}
});
const data = await response.json();
if (data.general.status === 'completed') {
console.log(`Valid: ${data.stats.valid}/${data.stats.requested}`);
console.log(data.results);
}
import requests
import os
batch_id = "3d4cb64e-i64d-41e8-a686-736751004a32"
url = f"https://api.enrow.io/email/find/bulk?id={batch_id}"
headers = {
"x-api-key": os.getenv("ENROW_API_KEY")
}
response = requests.get(url, headers=headers)
data = response.json()
if data["general"]["status"] == "completed":
print(f"Valid: {data['stats']['valid']}/{data['stats']['requested']}")
{
"general": {
"id": "3d4cb64e-i64d-41e8-a686-736751004a32",
"status": "completed",
"custom": "campaign_q2"
},
"stats": {
"finished": 3,
"requested": 3,
"valid": 2,
"credits_cost": {
"initial": 3,
"refunded": 1,
"final": 2
}
},
"results": [
{
"index": "0",
"qualification": "valid",
"email": "dwight.schrute@dundermifflin.com",
"info": {
"domain": "dundermifflin.com",
"firstname": "Dwight",
"lastname": "Schrute",
"companyInfo": {
"name": "Dunder Mifflin"
}
},
"raw_params": {
"company_domain": "dundermifflin.com",
"fullname": "Dwight Schrute"
},
"custom": "lead_001"
},
{
"index": "1",
"qualification": "valid",
"email": "jim.halpert@dundermifflin.com",
"info": {
"domain": "dundermifflin.com",
"firstname": "Jim",
"lastname": "Halpert",
"companyInfo": {
"name": "Dunder Mifflin"
}
},
"raw_params": {
"company_domain": "dundermifflin.com",
"fullname": "Jim Halpert"
},
"custom": "lead_002"
},
{
"index": "2",
"qualification": "invalid",
"email": null,
"raw_params": {
"company_domain": "dundermifflin.com",
"fullname": "Ryan Howard"
},
"custom": "lead_003"
}
]
}
{
"message": "..."
}
Email Finder
Obter Resultados
Recupere os resultados, as estatísticas e o detalhamento de créditos de uma busca de e-mails em massa por ID de lote
GET
/
email
/
find
/
bulk
curl --request GET \
--url 'https://api.enrow.io/email/find/bulk?id=3d4cb64e-i64d-41e8-a686-736751004a32' \
--header 'x-api-key: YOUR_API_KEY'
const batchId = '3d4cb64e-i64d-41e8-a686-736751004a32';
const response = await fetch(`https://api.enrow.io/email/find/bulk?id=${batchId}`, {
headers: {
'x-api-key': process.env.ENROW_API_KEY
}
});
const data = await response.json();
if (data.general.status === 'completed') {
console.log(`Valid: ${data.stats.valid}/${data.stats.requested}`);
console.log(data.results);
}
import requests
import os
batch_id = "3d4cb64e-i64d-41e8-a686-736751004a32"
url = f"https://api.enrow.io/email/find/bulk?id={batch_id}"
headers = {
"x-api-key": os.getenv("ENROW_API_KEY")
}
response = requests.get(url, headers=headers)
data = response.json()
if data["general"]["status"] == "completed":
print(f"Valid: {data['stats']['valid']}/{data['stats']['requested']}")
{
"general": {
"id": "3d4cb64e-i64d-41e8-a686-736751004a32",
"status": "completed",
"custom": "campaign_q2"
},
"stats": {
"finished": 3,
"requested": 3,
"valid": 2,
"credits_cost": {
"initial": 3,
"refunded": 1,
"final": 2
}
},
"results": [
{
"index": "0",
"qualification": "valid",
"email": "dwight.schrute@dundermifflin.com",
"info": {
"domain": "dundermifflin.com",
"firstname": "Dwight",
"lastname": "Schrute",
"companyInfo": {
"name": "Dunder Mifflin"
}
},
"raw_params": {
"company_domain": "dundermifflin.com",
"fullname": "Dwight Schrute"
},
"custom": "lead_001"
},
{
"index": "1",
"qualification": "valid",
"email": "jim.halpert@dundermifflin.com",
"info": {
"domain": "dundermifflin.com",
"firstname": "Jim",
"lastname": "Halpert",
"companyInfo": {
"name": "Dunder Mifflin"
}
},
"raw_params": {
"company_domain": "dundermifflin.com",
"fullname": "Jim Halpert"
},
"custom": "lead_002"
},
{
"index": "2",
"qualification": "invalid",
"email": null,
"raw_params": {
"company_domain": "dundermifflin.com",
"fullname": "Ryan Howard"
},
"custom": "lead_003"
}
]
}
{
"message": "..."
}
GET
Recupere todos os resultados de uma busca de e-mails em lote usando o ID do lote. Autentique cada requisição com sua chave de API no cabeçalho
Consulte Error handling para a lista completa de códigos de status e formatos de resposta.
https://api.enrow.io/email/find/bulk?id={id}
x-api-key. O ID do lote é o id retornado quando você inicia um trabalho com o endpoint Find Bulk Emails.
Usar um webhook permite que você dispense a chamada a este endpoint GET. Consulte How Webhooks Work.
Parâmetros de Consulta
string
obrigatório
O
id retornado pela requisição POSTResposta
200 — Busca concluída
object
object
Estatísticas do lote
Mostrar propriedades de stats
Mostrar propriedades de stats
number
Número de buscas concluídas
number
Número total de buscas solicitadas
number
Número de e-mails válidos encontrados
object
Detalhamento de créditos. Os créditos são reembolsados para resultados inválidos ou não encontrados — consulte Credits & billing para saber como funcionam as cobranças e os reembolsos.
array
Array de resultados da busca
Mostrar propriedades de Result
Mostrar propriedades de Result
string
Posição no array de busca original
string
valid (e-mail encontrado) ou invalid (e-mail não encontrado). Por que binário?string
O endereço de e-mail descoberto (quando
valid)object
Informações de contato:
domain, firstname, lastname, gender, companyInfo. Os valores de firstname e lastname vêm com a inicial maiúscula. info só está presente para resultados válidos.object
Os parâmetros de busca originais enviados
string | object
Dados personalizados passados na busca original
200 — Busca ainda em andamento
Enquanto o lote está em execução, o endpoint GET retorna HTTP200 com um corpo reduzido no formato { general: { id, status: "ongoing" }, stats: { finished, requested } }.
object
id e status: "ongoing"object
Contagens de
finished e requestedRespostas de Erro
| Code | Message |
|---|---|
| 400 | Could not retrieve bulk search results |
curl --request GET \
--url 'https://api.enrow.io/email/find/bulk?id=3d4cb64e-i64d-41e8-a686-736751004a32' \
--header 'x-api-key: YOUR_API_KEY'
const batchId = '3d4cb64e-i64d-41e8-a686-736751004a32';
const response = await fetch(`https://api.enrow.io/email/find/bulk?id=${batchId}`, {
headers: {
'x-api-key': process.env.ENROW_API_KEY
}
});
const data = await response.json();
if (data.general.status === 'completed') {
console.log(`Valid: ${data.stats.valid}/${data.stats.requested}`);
console.log(data.results);
}
import requests
import os
batch_id = "3d4cb64e-i64d-41e8-a686-736751004a32"
url = f"https://api.enrow.io/email/find/bulk?id={batch_id}"
headers = {
"x-api-key": os.getenv("ENROW_API_KEY")
}
response = requests.get(url, headers=headers)
data = response.json()
if data["general"]["status"] == "completed":
print(f"Valid: {data['stats']['valid']}/{data['stats']['requested']}")
{
"general": {
"id": "3d4cb64e-i64d-41e8-a686-736751004a32",
"status": "completed",
"custom": "campaign_q2"
},
"stats": {
"finished": 3,
"requested": 3,
"valid": 2,
"credits_cost": {
"initial": 3,
"refunded": 1,
"final": 2
}
},
"results": [
{
"index": "0",
"qualification": "valid",
"email": "dwight.schrute@dundermifflin.com",
"info": {
"domain": "dundermifflin.com",
"firstname": "Dwight",
"lastname": "Schrute",
"companyInfo": {
"name": "Dunder Mifflin"
}
},
"raw_params": {
"company_domain": "dundermifflin.com",
"fullname": "Dwight Schrute"
},
"custom": "lead_001"
},
{
"index": "1",
"qualification": "valid",
"email": "jim.halpert@dundermifflin.com",
"info": {
"domain": "dundermifflin.com",
"firstname": "Jim",
"lastname": "Halpert",
"companyInfo": {
"name": "Dunder Mifflin"
}
},
"raw_params": {
"company_domain": "dundermifflin.com",
"fullname": "Jim Halpert"
},
"custom": "lead_002"
},
{
"index": "2",
"qualification": "invalid",
"email": null,
"raw_params": {
"company_domain": "dundermifflin.com",
"fullname": "Ryan Howard"
},
"custom": "lead_003"
}
]
}
{
"message": "..."
}
Próximos passos
Encontrar e-mails em massa
Inicie um novo lote de até 5.000 buscas de e-mail.
Webhooks
Dispense o polling e seja notificado quando um lote for concluído.
Credits & billing
Veja como os créditos são cobrados e reembolsados por resultado.
Verificar e-mails em massa
Valide uma lista de endereços de e-mail em um único lote.
Esta página foi útil?

