// post /v1/bulk/finder
Bulk-E-Mail-Finder-API
Lösen Sie Tausende von Namens- und Firmenkombinationen über einen Massen-API-Job in verifizierte professionelle E-Mails auf.
Names, with a domain or company nameBis zu 10,000 Zeilen
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"]// 01 · anfrage
Massen-Email Finder ist eine HTTPS-Anfrage
Senden Sie die Parameter mit Ihrem Schlüssel und Secret. Jedes SDK, die CLI und der MCP-Server stellen genau diesen Aufruf.
- type
- finder
- list | data | file
- Names, with a domain or company name
- launch
- true startet den Job sofort
- webhook_url
- Erhält ein signiertes Ereignis, wenn der Job endet
- rows
- Bis zu 10,000 pro Job
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"]// 02 · antwort
Was zurückkommt
JSON, in jeder Sprache gleich. Felder, die Tomba nicht kennt, sind null und werden nie geraten.
GET
/email-finderdata.emailstring | null- The address, or null when none is found
data.scoreinteger- Confidence from 0 to 100
data.verification.statusstring | null- valid, accept_all, invalid or unknown, with verification.date
data.full_name, data.position, data.departmentstring | null- Name, job title and team
data.typestring | null- personal or generic (a role address such as sales@)
data.linkedin, data.twitterstring | null- Public profiles
data.sources[]array | null- Up to 20 public pages where the address was found, with dates
data.accept_allboolean | null- The domain accepts mail for any address (catch-all)
data.phone_numberboolean- Tomba holds a phone number for the person
data.phone_data[]array- The numbers, when you send enrich_mobile (each as in Phone Finder)
POST /bulk/finder
201 Created
{
"data": {
"id": 1042
}
}Jede Zeile, wie GET /email-finder sie zurückgibt
200 OK
{
"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 Aufruf kostet
Ein Aufruf wird nur unter der unten genannten Bedingung berechnet. Die Rate Limits hängen von Ihrem Tarif ab.
// kosten
1 search credit per row whose address is verified valid. Plus 5 per row with phone data.
Charged once, at the first download; later downloads are free
- 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)
Erstellen Sie einen Massenvorgang, indem Sie Namens-/Domänenpaare hochladen, und starten Sie dann den Vorgang. Die API verarbeitet alle Suchvorgänge asynchron. Verwenden Sie Webhooks oder Umfragen, um benachrichtigt zu werden, wenn die Verarbeitung abgeschlossen ist, und laden Sie dann die Ergebnisse herunter.
Sie können bis zu 10.000 Namens-/Domänensuchen pro Massenvorgang verarbeiten. Erstellen Sie für größere Datensätze mehrere Massenvorgänge.
Laden Sie Daten mit Spalten für Vorname, Nachname und Domäne (Unternehmenswebsite) hoch. Die API findet für jede Person die wahrscheinlichste E-Mail-Adresse.
Die Bearbeitungszeit hängt von der Größe der Liste und den nötigen Abfragen ab. Fragen Sie den Status des Jobs ab oder richten Sie einen Webhook ein, um zu erfahren, wann er abgeschlossen ist.
Jedes Ergebnis umfasst die E-Mail-Adresse, den vollständigen Namen, das Unternehmen, die Position, den Vertrauenswert, den Verifizierungsstatus und Quellen. Die Ergebnisse können als CSV oder JSON heruntergeladen werden.
Ja, konfigurieren Sie eine Webhook-URL, um eine Benachrichtigung zu erhalten, wenn Ihr Massenvorgang abgeschlossen ist. Die Webhook-Nutzlast umfasst die Bulk_ID und den Status.
Verwenden Sie GET /v1/bulk/email-finder/{bulk_id}, um den Status Ihres Vorgangs zu überprüfen. Zu den Statuswerten gehören „Ausstehend“, „In Bearbeitung“, „Abgeschlossen“ und „Fehlgeschlagen“.
Jede erfolgreich gefundene E-Mail zählt als 1 Anfrage. Suchvorgänge, die keine Ergebnisse liefern, werden nicht auf Ihr Kontingent angerechnet.
Verwenden Sie korrekte Vor- und Nachnamen mit der richtigen Stammdomäne des Unternehmens. Saubere Eingabedaten verbessern die Übereinstimmungsqualität und das Vertrauen erheblich.
Ja. Führen Sie die Ergebnisse nach Abschluss des Massenauftrags über den Bulk Email Verifier aus, um das Absprungrisiko vor dem Start der Kampagne zu verringern.