// operazioni in blocco
Ricerca Domini in Blocco
Carica un CSV di domini aziendali e trova tutti gli indirizzi email associati in una volta sola.
- 01pending
POST /v1/bulk/search201 · { "data": { "id": 1042 } } - 02running
launch: trueavanzamento interrogato con GET /v1/bulk/search/1042/progress - 03completed
bulk.completedwebhook firmato consegnato al tuo webhook_url
GET /v1/bulk/search/1042/download?file=fullAddebitato al primo download · il job scade dopo 180 giorni// 01 · input
L'input di un job Domain Search in blocco
Carica nell'app un CSV fino a 4 MB, oppure invia una lista, delle righe o un file a POST /v1/bulk/search. Le colonne vengono individuate dalla riga di intestazione; imposta un indice di campo per sceglierne una tu stesso.
/bulk/searchColonnedomain_field_index- Domain
company_name_field_index- Company name
/bulk/searchOpzioniinput_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 richiesta avvia il job
Crealo e avvialo con una sola chiamata, poi seguine l'avanzamento o ricevi un evento firmato bulk.completed. Ogni riga di risultato è ciò che restituisce 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 · costi e limiti
Quanto costa un job
Creare o avviare un job non costa nulla. Il costo viene addebitato una sola volta, al primo download dei risultati.
// fatturazione per riga
Per domain with at least one address: 1 search credit per 10 addresses returned, at most 10. Plus 5 per address with phone data.
Fatturazione dei job in blocco nella documentazione- Righe: fino a 25,000 per 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 · usalo ovunque
Esegui job Domain Search dall'app o dal tuo codice
Lo stesso job, gli stessi crediti: carica un file nell'app, chiama l'API o lavora da un foglio di calcolo o da uno strumento no-code.
- API RESTJSON su HTTPS, 13 SDK, webhook firmati.
GET /v1/domain-search - CSV in bloccoCarica una lista nell'app o inviala con POST a /bulk; scaricala quando è pronta.
POST /v1/bulk/{type} - Google Sheets ed ExcelFormule e una barra laterale che chiamano gli stessi endpoint.
=TOMBA_SEARCH(A2) - Zapier, Make, n8nAzioni no-code per finder, verifier e arricchimento.
Zapier · Make · n8n · Pipedream
Il riferimento completo della richiesta: /api/bulk/domain-search
// benchmark su 5.000 lead
Più email valide rispetto agli altri otto strumenti che abbiamo testato
Dati reali. Stesso input. Nessun intervento umano. Piena trasparenza. Abbiamo fatto un confronto diretto con lo stesso file di 5.000 righe su più strumenti di ricerca email.
| Posizione | Strumento | Da siti web | Da nomi di aziende | Totale |
|---|---|---|---|---|
| 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% | Meno dell'1% trovato da nomi di aziende: lo strumento richiede un sito web o un dominio:190.8% | 1,007 | |
| 9 | 82433.0% | Meno dell'1% trovato da nomi di aziende: lo strumento richiede un sito web o un dominio:220.9% | 846 |
Tomba.io ha trovato 4,015 email valide da 5,000 lead: #1 su 9 strumenti testati.
Test interno di Tomba, febbraio 2026. Un unico file di 5.000 lead, 2.500 con il sito web dell'azienda e 2.500 con il solo nome dell'azienda, elaborato da ogni strumento senza pulizia manuale. Contano solo gli indirizzi che uno strumento ha etichettato come validi o verificati; le percentuali si riferiscono ai 2.500 input di ciascun tipo.
Meno dell'1% trovato da nomi di aziende: lo strumento richiede un sito web o un dominio.