// operações em massa
Verificador de Emails em Massa
Envie um CSV com endereços de email e verifique todos quanto à entregabilidade de uma só vez.
- 01pending
POST /v1/bulk/verifier201 · { "data": { "id": 1042 } } - 02running
launch: trueprogresso consultado com GET /v1/bulk/verifier/1042/progress - 03completed
bulk.completedwebhook assinado entregue no seu webhook_url
GET /v1/bulk/verifier/1042/download?file=fullCobrado no primeiro download · o job expira após 180 dias// 01 · entrada
A entrada de um job em massa de Email Verifier
Envie um CSV de até 4 MB no app, ou envie uma lista, linhas ou um arquivo para POST /v1/bulk/verifier. As colunas são identificadas pela linha de cabeçalho; defina um índice de campo para escolher você mesmo.
/bulk/verifierColunasemail_field_index- Email address
/bulk/verifierOpçõesfind_phones- true adds phone numbers, at an extra cost
include_sources- true adds the web pages where each address was found
// 02 · api
Uma requisição inicia o job
Crie e inicie em uma única chamada, depois acompanhe o progresso ou receba um evento bulk.completed assinado. Cada linha de resultado é o que GET /email-verifier retorna.
curl -X POST "https://api.tomba.io/v1/bulk/verifier" \
-H "X-Tomba-Key: $TOMBA_API_KEY" \
-H "X-Tomba-Secret: $TOMBA_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"Email Verifier job","list":"richard@piedpiper.com\njohn@example.com","launch":true,"webhook_url":"https://hooks.example.com/tomba"}'const res = await fetch("https://api.tomba.io/v1/bulk/verifier", {
method: "POST",
headers: {
"X-Tomba-Key": process.env.TOMBA_API_KEY,
"X-Tomba-Secret": process.env.TOMBA_SECRET_KEY,
"Content-Type": "application/json"
},
body: JSON.stringify({
"name": "Email Verifier job",
"list": "richard@piedpiper.com\njohn@example.com",
"launch": true,
"webhook_url": "https://hooks.example.com/tomba"
})
});
const { data } = await res.json(); // { id }import os, requests
res = requests.post(
"https://api.tomba.io/v1/bulk/verifier",
headers={
"X-Tomba-Key": os.environ["TOMBA_API_KEY"],
"X-Tomba-Secret": os.environ["TOMBA_SECRET_KEY"],
},
json={
"name": "Email Verifier job",
"list": "richard@piedpiper.com\njohn@example.com",
"launch": True,
"webhook_url": "https://hooks.example.com/tomba"
},
)
job_id = res.json()["data"]["id"]{
"data": {
"id": 1042
}
}{
"data": {
"email": {
"email": "richard@piedpiper.com",
"result": "deliverable",
"status": "valid",
"score": 99,
"smtp_provider": "Google",
"mx": {
"records": [
"aspmx.l.google.com",
"alt1.aspmx.l.google.com"
]
},
"mx_check": true,
"smtp_server": true,
"smtp_check": true,
"accept_all": false,
"greylisted": false,
"block": false,
"gibberish": false,
"disposable": false,
"webmail": false,
"regex": true,
"whois": {
"registrar_name": null,
"referral_url": null,
"created_date": null
}
},
"sources": [
{
"uri": "https://piedpiper.com/blog/engineering",
"website_url": "piedpiper.com",
"extracted_on": "2024-06-01T09:14:07+01:00",
"last_seen_on": "2025-01-10T17:02:44+01:00",
"still_on_page": true
}
],
"phone_data": null
}
}// 03 · custo e limites
Quanto custa um job
Nada é cobrado para criar ou iniciar um job. O custo é cobrado uma única vez, no primeiro download dos resultados.
// cobrança por linha
1 verification credit per row, except disposable addresses. Plus 5 search credits per row with phone data.
Cobrança de jobs em massa na documentação- Linhas: até 20,000 por job
- Jobs created: 15 per day for each type
- Running jobs: 2 per type
- Downloads: 25 per day for each job
- Request size: 4 MB (CSV, list or rows)
// 04 · use em qualquer lugar
Execute jobs de Email Verifier pelo app ou pelo seu código
O mesmo job, os mesmos créditos: envie um arquivo no app, chame a API ou trabalhe a partir de uma planilha ou de uma ferramenta no-code.
- API RESTJSON via HTTPS, 13 SDKs, webhooks assinados.
GET /v1/email-finder - CSV em massaEnvie uma lista no app ou faça POST para /bulk; baixe quando estiver pronta.
POST /v1/bulk/{type} - Google Sheets e ExcelFórmulas e uma barra lateral que chamam os mesmos endpoints.
=TOMBA_VERIFY(A2) - Zapier, Make, n8nAções no-code para o buscador, o verificador e o enriquecimento.
Zapier · Make · n8n · Pipedream
A referência completa da requisição: /api/bulk/email-verifier
// clientes
Equipes que executam jobs de Email Verifier
Tomba is my go-to to validate emails. Even in a waterfall process with multiple tools, Tomba is usually the top choice.
Nuno PoçoSales Automation Architect, clickworks.ioThe data is always fresh, and the n8n integration is excellent. Support is very responsive. I'd rate it 9/10.
Benjie MalinaoCo-Founder & CTO, Channel Automation