// post /v1/bulk/verifier
API de verificación de correo electrónico masivo
Limpie y califique listas de correo electrónico de gran volumen con un canal de verificación asincrónica creado para remitentes a escala.
Email addressesHasta 20,000 filas
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"]// 01 · solicitud
Email Verifier masivo es una solicitud HTTPS
Envía los parámetros con tu clave y tu secreto. Cada SDK, la CLI y el servidor MCP hacen esta misma llamada.
- type
- verifier
- list | data | file
- Email addresses
- launch
- true inicia el trabajo de inmediato
- webhook_url
- Recibe un evento firmado cuando termina el trabajo
- rows
- Hasta 20,000 por trabajo
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"]// 02 · respuesta
Lo que recibes
JSON, igual en todos los lenguajes. Los campos que Tomba no conoce son null, nunca se adivinan.
GET
/email-verifierdata.email.resultstring- deliverable, risky or undeliverable; empty for a disposable domain
data.email.statusstring- valid, accept_all, invalid, unknown or disposable (compare case-insensitively: a live check can return Valid)
data.email.scoreinteger- Confidence: 99 for valid, 77 or more for accept_all, 2 for disposable
data.email.smtp_providerstring | null- Mail provider from the MX records, such as Google
data.email.mx.recordsarray | null- The domain's MX hosts
data.email.mx_check, data.email.smtp_checkboolean- The domain has MX records (smtp_check is the same check; status says whether the mailbox exists)
data.email.accept_all, data.email.greylisted, data.email.blockboolean- Catch-all domain, check deferred, check refused by the server
data.email.disposable, data.email.webmail, data.email.gibberish, data.email.regexboolean- Disposable or webmail domain, random-looking address, valid syntax
data.sources[]array- Where the address was found
data.phone_data[]array | null- Phone numbers, when you send enrich_mobile
POST /bulk/verifier
201 Created
{
"data": {
"id": 1042
}
}Cada fila, tal como la devuelve GET /email-verifier
200 OK
{
"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 · coste y límites
Lo que cuesta una llamada
Una llamada solo se cobra en la condición indicada abajo. Los límites de solicitudes dependen de tu plan.
// coste
1 verification credit per row, except disposable addresses. Plus 5 search credits per row with phone data.
Charged once, at the first download; later downloads are free
- 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)
Cree una operación masiva cargando una lista de direcciones de correo electrónico y luego inicie la operación. La API verifica todos los correos electrónicos de forma asincrónica mediante comprobaciones multicapa. Utilice webhooks o encuestas para monitorear el progreso.
Puede verificar hasta 100.000 direcciones de correo electrónico por operación masiva. Para listas más grandes, cree varias operaciones masivas.
Cada correo electrónico se somete a validación de sintaxis, verificaciones de registros MX, verificación SMTP, detección desechable, detección general y puntuación de capacidad de entrega.
Si una dirección que Tomba devolvió como válida tiene un rebote duro, el crédito se devuelve según la garantía de calidad de datos (resultado deliverable del verificador o puntuación del buscador de 60 o más, enviada en un plazo de 30 días desde un dominio con SPF, DKIM y DMARC).
La velocidad depende del tamaño de la lista y de la rapidez con que responde cada servidor de correo. Consulte el estado del trabajo o configure un webhook para saber cuándo termina.
Cada resultado incluye el correo electrónico, el estado de verificación (válido, no válido, aceptar_todo, desconocido), puntuación de confianza, indicador desechable, proveedor SMTP y registros MX.
Una vez que se complete el procesamiento, use el punto final de descarga para obtener resultados como CSV o JSON. Los resultados incluyen todos los datos de verificación de cada correo electrónico.
Sí, configure una URL de webhook para recibir notificaciones cuando se complete su verificación masiva o cuando se produzcan errores durante el procesamiento.
Los dominios de aceptación total pueden ser válidos pero más riesgosos. Priorice puntuaciones de confianza más altas y considere estrategias de envío segmentadas para estos registros.
Verifique las listas cercanas a la hora de envío, suprima las direcciones no válidas y desechables y vuelva a verificar las listas más antiguas periódicamente para mantener la capacidad de entrega.