// operations en masse
Recherche de Domaines en Masse
Importez un CSV de domaines d'entreprises et trouvez toutes les adresses e-mail associees en une seule fois.
- 01pending
POST /v1/bulk/search201 · { "data": { "id": 1042 } } - 02running
launch: trueprogression interrogée avec GET /v1/bulk/search/1042/progress - 03completed
bulk.completedwebhook signé envoyé à votre webhook_url
GET /v1/bulk/search/1042/download?file=fullFacturé au premier téléchargement · la tâche expire au bout de 180 jours// 01 · entrée
L'entrée d'une tâche Domain Search en masse
Importez un CSV de 4 Mo maximum dans l'application, ou envoyez une liste, des lignes ou un fichier à POST /v1/bulk/search. Les colonnes sont détectées à partir de la ligne d'en-tête ; indiquez un index de champ pour en choisir une vous-même.
/bulk/searchColonnesdomain_field_index- Domain
company_name_field_index- Company name
/bulk/searchOptionsinput_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
Une seule requête lance la tâche
Créez-la et lancez-la en un seul appel, puis suivez sa progression ou recevez un événement bulk.completed signé. Chaque ligne de résultat correspond à ce que renvoie 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 · coût et limites
Ce que coûte une tâche
La création ou le lancement d'une tâche ne coûte rien. Son coût est facturé une seule fois, au premier téléchargement des résultats.
// facturation par ligne
Per domain with at least one address: 1 search credit per 10 addresses returned, at most 10. Plus 5 per address with phone data.
La facturation des tâches en masse dans la documentation- Lignes : jusqu'à 25,000 par tâche
- 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 · utilisable partout
Lancez des tâches Domain Search depuis l'application ou votre code
La même tâche, les mêmes crédits : importez un fichier dans l'application, appelez l'API, ou travaillez depuis un tableur ou un outil no-code.
- API RESTJSON sur HTTPS, 13 SDK, webhooks signés.
GET /v1/domain-search - CSV en masseImportez une liste dans l'application ou envoyez-la en POST à /bulk ; téléchargez-la une fois terminée.
POST /v1/bulk/{type} - Google Sheets et ExcelDes formules et une barre latérale qui appellent les mêmes endpoints.
=TOMBA_SEARCH(A2) - Zapier, Make, n8nDes actions no-code pour la recherche, la vérification et l'enrichissement.
Zapier · Make · n8n · Pipedream
La référence complète de la requête : /api/bulk/domain-search
// benchmark sur 5 000 leads
Plus d'e-mails valides que les huit autres outils testés
Des données réelles. Les mêmes entrées. Aucune intervention manuelle. Une transparence totale. Nous avons comparé plusieurs outils de recherche d'emails avec le même fichier de 5 000 lignes.
| Rang | Outil | À partir de sites web | À partir de noms d'entreprise | 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% | Moins de 1 % trouvé à partir des noms d'entreprise : l'outil a besoin d'un site web ou d'un domaine:190.8% | 1,007 | |
| 9 | 82433.0% | Moins de 1 % trouvé à partir des noms d'entreprise : l'outil a besoin d'un site web ou d'un domaine:220.9% | 846 |
Tomba.io a trouvé 4,015 e-mails valides à partir de 5,000 leads : 1e sur 9 outils testés.
Test réalisé par Tomba, février 2026. Un fichier de 5 000 leads, dont 2 500 avec le site web de l'entreprise et 2 500 avec seulement son nom, passé dans chaque outil sans nettoyage manuel. Seules comptent les adresses qu'un outil a marquées comme valides ou vérifiées ; les pourcentages portent sur les 2 500 entrées de chaque type.
Moins de 1 % trouvé à partir des noms d'entreprise : l'outil a besoin d'un site web ou d'un domaine.