// massenverarbeitung
Massen-E-Mail-Suche
Laden Sie eine CSV-Datei mit Namen und Domains hoch, um alle professionellen E-Mail-Adressen auf einmal zu finden.
- 01pending
POST /v1/bulk/finder201 · { "data": { "id": 1042 } } - 02running
launch: trueFortschritt abgefragt mit GET /v1/bulk/finder/1042/progress - 03completed
bulk.completedsignierter Webhook an Ihre webhook_url zugestellt
GET /v1/bulk/finder/1042/download?file=fullBerechnet beim ersten Download · der Job läuft nach 180 Tagen ab// 01 · eingabe
Die Eingabe eines Email Finder-Massen-Jobs
Laden Sie in der App eine CSV-Datei mit bis zu 4 MB hoch oder senden Sie eine Liste, Zeilen oder eine Datei an POST /v1/bulk/finder. Spalten werden anhand der Kopfzeile erkannt; legen Sie einen Feldindex fest, um selbst eine auszuwählen.
/bulk/finderSpaltendomain_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/finderOptionenfind_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
Eine Anfrage startet den Job
Erstellen und starten Sie ihn mit einem Aufruf, verfolgen Sie dann den Fortschritt oder empfangen Sie ein signiertes bulk.completed-Ereignis. Jede Ergebniszeile entspricht dem, was GET /email-finder zurückgibt.
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 und limits
Was ein Job kostet
Für das Erstellen oder Starten eines Jobs wird nichts berechnet. Seine Kosten werden einmalig beim ersten Download der Ergebnisse abgerechnet.
// abrechnung pro zeile
1 search credit per row whose address is verified valid. Plus 5 per row with phone data.
Abrechnung von Massen-Jobs in der Dokumentation- Zeilen: bis zu 10,000 pro 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 · überall nutzbar
Email Finder-Jobs aus der App oder Ihrem Code ausführen
Derselbe Job, dieselben Credits: Laden Sie eine Datei in der App hoch, rufen Sie die API auf oder arbeiten Sie aus einer Tabelle oder einem No-Code-Tool.
- REST-APIJSON über HTTPS, 13 SDKs, signierte Webhooks.
GET /v1/email-finder - Massen-CSVLaden Sie eine Liste in der App hoch oder senden Sie sie per POST an /bulk; laden Sie sie herunter, wenn sie fertig ist.
POST /v1/bulk/{type} - Google Sheets und ExcelFormeln und eine Seitenleiste, die dieselben Endpunkte aufrufen.
=TOMBA_FIND(A2, B2) - Zapier, Make, n8nNo-Code-Aktionen für Finder, Verifizierer und Anreicherung.
Zapier · Make · n8n · Pipedream
Die vollständige Anfrage-Referenz: /api/bulk/email-finder
// benchmark mit 5.000 leads
Mehr gültige E-Mails als die acht anderen getesteten Tools
Echte Daten. Gleiche Eingabe. Kein manueller Eingriff. Volle Transparenz. Wir haben einen direkten Vergleichstest mit derselben Eingabedatei von 5.000 Zeilen in mehreren E-Mail-Finder-Tools durchgeführt.
| Rang | Tool | Aus Websites | Aus Firmennamen | Gesamt |
|---|---|---|---|---|
| 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% | Unter 1 % aus Firmennamen gefunden: Das Tool benötigt eine Website oder Domain:190.8% | 1,007 | |
| 9 | 82433.0% | Unter 1 % aus Firmennamen gefunden: Das Tool benötigt eine Website oder Domain:220.9% | 846 |
Tomba.io hat aus 5,000 Leads 4,015 gültige E-Mails gefunden: Platz 1 von 9 getesteten Tools.
Tombas eigener Test, Februar 2026. Eine Datei mit 5.000 Leads, 2.500 mit der Firmenwebsite und 2.500 nur mit dem Firmennamen, lief ohne manuelle Bereinigung durch jedes Tool. Es zählen nur Adressen, die ein Tool als gültig oder verifiziert markiert hat; die Prozentwerte beziehen sich auf die 2.500 Eingaben jeder Art.
Unter 1 % aus Firmennamen gefunden: Das Tool benötigt eine Website oder Domain.