// massenverarbeitung
Massen-Domain-Suche
Laden Sie eine CSV-Datei mit Unternehmensdomains hoch und finden Sie alle zugehörigen E-Mail-Adressen auf einmal.
- 01pending
POST /v1/bulk/search201 · { "data": { "id": 1042 } } - 02running
launch: trueFortschritt abgefragt mit GET /v1/bulk/search/1042/progress - 03completed
bulk.completedsignierter Webhook an Ihre webhook_url zugestellt
GET /v1/bulk/search/1042/download?file=fullBerechnet beim ersten Download · der Job läuft nach 180 Tagen ab// 01 · eingabe
Die Eingabe eines Domain Search-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/search. Spalten werden anhand der Kopfzeile erkannt; legen Sie einen Feldindex fest, um selbst eine auszuwählen.
/bulk/searchSpaltendomain_field_index- Domain
company_name_field_index- Company name
/bulk/searchOptioneninput_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
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 /domain-search zurückgibt.
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 · 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
Per domain with at least one address: 1 search credit per 10 addresses returned, at most 10. Plus 5 per address with phone data.
Abrechnung von Massen-Jobs in der Dokumentation- Zeilen: bis zu 25,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
Domain Search-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/domain-search - 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_SEARCH(A2) - Zapier, Make, n8nNo-Code-Aktionen für Finder, Verifizierer und Anreicherung.
Zapier · Make · n8n · Pipedream
Die vollständige Anfrage-Referenz: /api/bulk/domain-search
// 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.