// operaciones en masa
Buscador de Correos en Masa
Sube un CSV con nombres y dominios para encontrar todas las direcciones de correo profesionales de una sola vez.
- 01pending
POST /v1/bulk/finder201 · { "data": { "id": 1042 } } - 02running
launch: trueprogreso consultado con GET /v1/bulk/finder/1042/progress - 03completed
bulk.completedwebhook firmado entregado en tu webhook_url
GET /v1/bulk/finder/1042/download?file=fullSe cobra en la primera descarga · el trabajo caduca a los 180 días// 01 · entrada
La entrada de un trabajo masivo de Email Finder
Sube un CSV de hasta 4 MB en la app, o envía una lista, filas o un archivo a POST /v1/bulk/finder. Las columnas se detectan a partir de la fila de encabezado; indica un índice de campo para elegir una tú mismo.
/bulk/finderColumnasdomain_field_index- Domain
company_name_field_index- Company name
first_name_field_index, last_name_field_index- First name, last name
full_name_field_index- Full name
/bulk/finderOpcionesfind_phones- true adds phone numbers, at an extra cost
include_sources- true adds the web pages where each address was found
skip_rows_with_email- true skips rows that already have a value in an email column
// 02 · api
Una solicitud inicia el trabajo
Créalo y lánzalo en una sola llamada; después sigue su progreso o recibe un evento firmado bulk.completed. Cada fila de resultado es lo que devuelve GET /email-finder.
curl -X POST "https://api.tomba.io/v1/bulk/finder" \
-H "X-Tomba-Key: $TOMBA_API_KEY" \
-H "X-Tomba-Secret: $TOMBA_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"Conference leads","data":[["first_name","last_name","company_website"],["Richard","Hendricks","piedpiper.com"]],"launch":true,"webhook_url":"https://hooks.example.com/tomba"}'const res = await fetch("https://api.tomba.io/v1/bulk/finder", {
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": "Conference leads",
"data": [
[
"first_name",
"last_name",
"company_website"
],
[
"Richard",
"Hendricks",
"piedpiper.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/finder",
headers={
"X-Tomba-Key": os.environ["TOMBA_API_KEY"],
"X-Tomba-Secret": os.environ["TOMBA_SECRET_KEY"],
},
json={
"name": "Conference leads",
"data": [
[
"first_name",
"last_name",
"company_website"
],
[
"Richard",
"Hendricks",
"piedpiper.com"
]
],
"launch": True,
"webhook_url": "https://hooks.example.com/tomba"
},
)
job_id = res.json()["data"]["id"]{
"data": {
"id": 1042
}
}{
"data": {
"email": "richard@piedpiper.com",
"first_name": "Richard",
"last_name": "Hendricks",
"full_name": "Richard Hendricks",
"website_url": "piedpiper.com",
"company": "Pied Piper",
"pattern": "{first}",
"department": "executive",
"type": "personal",
"position": "CEO",
"country": "US",
"gender": "male",
"twitter": null,
"linkedin": "https://www.linkedin.com/in/richard-hendricks",
"score": 100,
"accept_all": false,
"phone_number": true,
"verification": {
"date": "2025-01-15T10:32:00+01:00",
"status": "valid"
},
"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": []
}
}// 03 · coste y límites
Lo que cuesta un trabajo
Crear o lanzar un trabajo no se cobra. Su coste se cobra una sola vez, en la primera descarga de sus resultados.
// facturación por fila
1 search credit per row whose address is verified valid. Plus 5 per row with phone data.
Facturación masiva en la documentación- Filas: hasta 10,000 por trabajo
- 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 · úsalo en cualquier parte
Ejecuta trabajos de Email Finder desde la app o tu código
El mismo trabajo, los mismos créditos: sube un archivo en la app, llama a la API o trabaja desde una hoja de cálculo o una herramienta no-code.
- API RESTJSON sobre HTTPS, 13 SDK, webhooks firmados.
GET /v1/email-finder - CSV masivoSube una lista en la app o envíala por POST a /bulk; descárgala cuando termine.
POST /v1/bulk/{type} - Google Sheets y ExcelFórmulas y una barra lateral que llaman a los mismos endpoints.
=TOMBA_FIND(A2, B2) - Zapier, Make, n8nAcciones no-code para el buscador, el verificador y el enriquecimiento.
Zapier · Make · n8n · Pipedream
La referencia completa de la solicitud: /api/bulk/email-finder
// benchmark de 5.000 leads
Más emails válidos que las otras ocho herramientas que probamos
Datos reales. La misma entrada. Sin intervención manual. Total transparencia. Hicimos una prueba directa con el mismo archivo de 5.000 líneas en varias herramientas de búsqueda de emails.
| Posición | Herramienta | Desde sitios web | Desde nombres de empresa | Total |
|---|---|---|---|---|
| 1 |  Tomba.ioSitios 2,026 · 81.0 % Nombres 1,989 · 79.6 % | 2,02681.0% | 1,98979.6% | 4,015 |
| 2 | 1,91876.7% | 1,95778.3% | 3,875 | |
| 3 | 1,88075.2% | 1,87775.1% | 3,757 | |
| 4 | 1,48359.3% | 1,61364.5% | 3,096 | |
| 5 | 1,00140.0% | 1,14145.6% | 2,142 | |
| 6 | 88735.5% | 99539.8% | 1,882 | |
| 7 | 1,05142.0% | 74930.0% | 1,800 | |
| 8 | 98839.5% | Menos del 1 % encontrado desde nombres de empresa: la herramienta necesita un sitio web o dominio:190.8% | 1,007 | |
| 9 | 82433.0% | Menos del 1 % encontrado desde nombres de empresa: la herramienta necesita un sitio web o dominio:220.9% | 846 |
Tomba.io encontró 4,015 emails válidos de 5,000 leads: n.º 1 de 9 herramientas probadas.
Prueba propia de Tomba, febrero de 2026. Un archivo de 5.000 leads, 2.500 con el sitio web de la empresa y 2.500 solo con el nombre de la empresa, procesado en cada herramienta sin limpieza manual. Solo cuentan las direcciones que una herramienta marcó como válidas o verificadas; los porcentajes se calculan sobre las 2.500 entradas de cada tipo.
Menos del 1 % encontrado desde nombres de empresa: la herramienta necesita un sitio web o dominio.