// operaciones en masa
Busqueda de Dominios en Masa
Sube un CSV con dominios de empresas y encuentra todas las direcciones de correo asociadas de una sola vez.
- 01pending
POST /v1/bulk/search201 · { "data": { "id": 1042 } } - 02running
launch: trueprogreso consultado con GET /v1/bulk/search/1042/progress - 03completed
bulk.completedwebhook firmado entregado en tu webhook_url
GET /v1/bulk/search/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 Domain Search
Sube un CSV de hasta 4 MB en la app, o envía una lista, filas o un archivo a POST /v1/bulk/search. Las columnas se detectan a partir de la fila de encabezado; indica un índice de campo para elegir una tú mismo.
/bulk/searchColumnasdomain_field_index- Domain
company_name_field_index- Company name
/bulk/searchOpcionesinput_type- domain or company; company when the input has a company name column and no domain column
max_emails_per_domain- Addresses per domain: 1, 10 (the default), 20, 50 or 100
email_type, email_type_mode- all (the default), personal or generic; only (the default) or priority
departments, departments_mode- Department names such as ["sales", "marketing"]; only or priority
verify_emails- true verifies the addresses found
find_phones- true adds phone numbers, at an extra cost
include_sources- true adds the web pages where each address was found
boost_score_from_sources- true adds 10 points, up to 90, to an unverified address found on at least 5 pages
// 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 /domain-search.
curl -X POST "https://api.tomba.io/v1/bulk/search" \
-H "X-Tomba-Key: $TOMBA_API_KEY" \
-H "X-Tomba-Secret: $TOMBA_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"Domain Search job","list":"piedpiper.com\nshopify.com\nnotion.so","launch":true,"webhook_url":"https://hooks.example.com/tomba"}'const res = await fetch("https://api.tomba.io/v1/bulk/search", {
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": "Domain Search job",
"list": "piedpiper.com\nshopify.com\nnotion.so",
"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/search",
headers={
"X-Tomba-Key": os.environ["TOMBA_API_KEY"],
"X-Tomba-Secret": os.environ["TOMBA_SECRET_KEY"],
},
json={
"name": "Domain Search job",
"list": "piedpiper.com\nshopify.com\nnotion.so",
"launch": True,
"webhook_url": "https://hooks.example.com/tomba"
},
)
job_id = res.json()["data"]["id"]{
"data": {
"id": 1042
}
}{
"data": {
"organization": {
"website_url": "piedpiper.com",
"organization": "Pied Piper",
"location": {
"country": "US",
"city": "Palo Alto",
"state": "CA",
"street_address": "5230 Newell Road",
"postal_code": "94303"
},
"social_links": {
"twitter_url": null,
"facebook_url": null,
"instagram_url": null,
"linkedin_url": "https://www.linkedin.com/company/pied-piper",
"github_url": null,
"youtube_url": null,
"pinterest_url": null,
"tiktok_url": null
},
"disposable": false,
"webmail": false,
"phone_number": false,
"industries": "computer software",
"founded": "2014",
"company_size": "11-50",
"company_type": "privately held",
"revenue": null,
"accept_all": false,
"description": "Middle-out compression for files and video.",
"pattern": "{first}",
"total_similar": 2,
"keywords": [
"compression",
"middle-out",
"decentralized internet"
],
"ranking": null,
"whois": {
"registrar_name": null,
"created_date": null,
"referral_url": null
},
"last_updated": "2025-01-15T10:32:00+01:00"
},
"emails": [
{
"email": "dinesh@piedpiper.com",
"first_name": "Dinesh",
"last_name": "Chugtai",
"full_name": "Dinesh Chugtai",
"gender": "male",
"phone_number": false,
"type": "personal",
"country": "US",
"position": "Software Engineer",
"department": "engineering",
"seniority": "senior",
"twitter": null,
"linkedin": null,
"score": 99,
"verification": {
"date": "2025-01-15T10:32:00+01:00",
"status": "valid"
},
"phone_data": [],
"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
}
]
},
{
"email": "gilfoyle@piedpiper.com",
"first_name": "Bertram",
"last_name": "Gilfoyle",
"full_name": "Bertram Gilfoyle",
"gender": "male",
"phone_number": false,
"type": "personal",
"country": "US",
"position": "Systems Architect",
"department": "engineering",
"seniority": "senior",
"twitter": null,
"linkedin": null,
"score": 97,
"verification": {
"date": "2025-01-15T10:32:00+01:00",
"status": "valid"
},
"phone_data": [],
"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
}
]
}
]
},
"meta": {
"total": 12,
"pageSize": 10,
"current": 1,
"total_pages": 2,
"params": {
"domain": "piedpiper.com",
"company": "",
"page": 1,
"limit": 10,
"department": "engineering",
"country": null,
"type": "all",
"live": false,
"enrich_mobile": false,
"webhook_url": null
}
}
}// 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
Per domain with at least one address: 1 search credit per 10 addresses returned, at most 10. Plus 5 per address with phone data.
Facturación masiva en la documentación- Filas: hasta 25,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 Domain Search 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/domain-search - 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_SEARCH(A2) - 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/domain-search
// 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 | 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.