// operations en masse
Recherche d'E-mails en Masse
Importez un CSV de noms et de domaines pour trouver toutes les adresses e-mail professionnelles en une seule fois.
- 01pending
POST /v1/bulk/finder201 · { "data": { "id": 1042 } } - 02running
launch: trueprogression interrogée avec GET /v1/bulk/finder/1042/progress - 03completed
bulk.completedwebhook signé envoyé à votre webhook_url
GET /v1/bulk/finder/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 Email Finder en masse
Importez un CSV de 4 Mo maximum dans l'application, ou envoyez une liste, des lignes ou un fichier à POST /v1/bulk/finder. 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/finderColonnesdomain_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/finderOptionsfind_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
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 /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 · 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
1 search credit per row whose address is verified valid. Plus 5 per row with phone data.
La facturation des tâches en masse dans la documentation- Lignes : jusqu'à 10,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 Email Finder 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/email-finder - 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_FIND(A2, B2) - 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/email-finder
// 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 |  Tomba.ioSites 2,026 · 81.0 % Noms 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% | 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.