// bulkbewerkingen
Bulk E-mail Zoeken
Upload een CSV met namen en domeinen om alle professionele e-mailadressen tegelijk te vinden.
- 01pending
POST /v1/bulk/finder201 · { "data": { "id": 1042 } } - 02running
launch: truevoortgang opgevraagd met GET /v1/bulk/finder/1042/progress - 03completed
bulk.completedondertekende webhook afgeleverd op je webhook_url
GET /v1/bulk/finder/1042/download?file=fullIn rekening gebracht bij de eerste download · de taak verloopt na 180 dagen// 01 · invoer
De invoer van een Email Finder-bulktaak
Upload in de app een CSV van maximaal 4 MB, of stuur een lijst, rijen of een bestand naar POST /v1/bulk/finder. Kolommen worden herkend aan de kopregel; stel een veldindex in om er zelf een te kiezen.
/bulk/finderKolommendomain_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/finderOptiesfind_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
Eén verzoek start de taak
Maak en start de taak in één aanroep, volg daarna de voortgang of ontvang een ondertekend bulk.completed-event. Elke resultaatrij is wat GET /email-finder teruggeeft.
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 · kosten en limieten
Wat een taak kost
Een taak aanmaken of starten kost niets. De kosten worden één keer in rekening gebracht, bij de eerste download van de resultaten.
// facturering per rij
1 search credit per row whose address is verified valid. Plus 5 per row with phone data.
Bulkfacturering in de documentatie- Rijen: tot 10,000 per taak
- 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 · overal te gebruiken
Voer Email Finder-taken uit vanuit de app of je code
Dezelfde taak, dezelfde credits: upload een bestand in de app, roep de API aan of werk vanuit een spreadsheet of een no-code-tool.
- REST APIJSON via HTTPS, 13 SDK's, ondertekende webhooks.
GET /v1/email-finder - Bulk-CSVUpload een lijst in de app of POST hem naar /bulk; download als hij klaar is.
POST /v1/bulk/{type} - Google Sheets en ExcelFormules en een zijbalk die dezelfde endpoints aanroepen.
=TOMBA_FIND(A2, B2) - Zapier, Make, n8nNo-code-acties voor de finder, de verifier en verrijking.
Zapier · Make · n8n · Pipedream
De volledige naslag van het verzoek: /api/bulk/email-finder
// benchmark met 5.000 leads
Meer geldige e-mailadressen dan de acht andere tools die we testten
Echte data. Dezelfde invoer. Geen handwerk. Volledige transparantie. We hebben hetzelfde invoerbestand van 5.000 regels door meerdere e-mailfinders gehaald in een directe vergelijking.
| Rang | Tool | Vanaf websites | Vanaf bedrijfsnamen | Totaal |
|---|---|---|---|---|
| 1 |  Tomba.ioSites 2,026 · 81.0% Namen 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% | Minder dan 1% gevonden vanaf bedrijfsnamen: de tool heeft een website of domein nodig:190.8% | 1,007 | |
| 9 | 82433.0% | Minder dan 1% gevonden vanaf bedrijfsnamen: de tool heeft een website of domein nodig:220.9% | 846 |
Tomba.io vond 4,015 geldige e-mailadressen uit 5,000 leads: #1 van 9 geteste tools.
Eigen test van Tomba, februari 2026. Eén bestand met 5.000 leads, 2.500 met de website van het bedrijf en 2.500 met alleen de bedrijfsnaam, door elke tool gehaald zonder handmatige opschoning. Alleen adressen die een tool als geldig of geverifieerd markeerde tellen mee; percentages zijn van de 2.500 invoerregels van elk type.
Minder dan 1% gevonden vanaf bedrijfsnamen: de tool heeft een website of domein nodig.