// massenverarbeitung
Massen-E-Mail-Verifizierung
Laden Sie eine CSV-Datei mit E-Mail-Adressen hoch und verifizieren Sie alle auf Zustellbarkeit auf einmal.
- 01pending
POST /v1/bulk/verifier201 · { "data": { "id": 1042 } } - 02running
launch: trueFortschritt abgefragt mit GET /v1/bulk/verifier/1042/progress - 03completed
bulk.completedsignierter Webhook an Ihre webhook_url zugestellt
GET /v1/bulk/verifier/1042/download?file=fullBerechnet beim ersten Download · der Job läuft nach 180 Tagen ab// 01 · eingabe
Die Eingabe eines Email Verifier-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/verifier. Spalten werden anhand der Kopfzeile erkannt; legen Sie einen Feldindex fest, um selbst eine auszuwählen.
/bulk/verifierSpaltenemail_field_index- Email address
/bulk/verifierOptionenfind_phones- true adds phone numbers, at an extra cost
include_sources- true adds the web pages where each address was found
// 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-verifier zurückgibt.
curl -X POST "https://api.tomba.io/v1/bulk/verifier" \
-H "X-Tomba-Key: $TOMBA_API_KEY" \
-H "X-Tomba-Secret: $TOMBA_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"Email Verifier job","list":"richard@piedpiper.com\njohn@example.com","launch":true,"webhook_url":"https://hooks.example.com/tomba"}'const res = await fetch("https://api.tomba.io/v1/bulk/verifier", {
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": "Email Verifier job",
"list": "richard@piedpiper.com\njohn@example.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/verifier",
headers={
"X-Tomba-Key": os.environ["TOMBA_API_KEY"],
"X-Tomba-Secret": os.environ["TOMBA_SECRET_KEY"],
},
json={
"name": "Email Verifier job",
"list": "richard@piedpiper.com\njohn@example.com",
"launch": True,
"webhook_url": "https://hooks.example.com/tomba"
},
)
job_id = res.json()["data"]["id"]{
"data": {
"id": 1042
}
}{
"data": {
"email": {
"email": "richard@piedpiper.com",
"result": "deliverable",
"status": "valid",
"score": 99,
"smtp_provider": "Google",
"mx": {
"records": [
"aspmx.l.google.com",
"alt1.aspmx.l.google.com"
]
},
"mx_check": true,
"smtp_server": true,
"smtp_check": true,
"accept_all": false,
"greylisted": false,
"block": false,
"gibberish": false,
"disposable": false,
"webmail": false,
"regex": true,
"whois": {
"registrar_name": null,
"referral_url": null,
"created_date": null
}
},
"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": 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
1 verification credit per row, except disposable addresses. Plus 5 search credits per row with phone data.
Abrechnung von Massen-Jobs in der Dokumentation- Zeilen: bis zu 20,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 Verifier-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-verifier - 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_VERIFY(A2) - Zapier, Make, n8nNo-Code-Aktionen für Finder, Verifizierer und Anreicherung.
Zapier · Make · n8n · Pipedream
Die vollständige Anfrage-Referenz: /api/bulk/email-verifier
// kunden
Teams, die Email Verifier-Jobs ausführen
Tomba is my go-to to validate emails. Even in a waterfall process with multiple tools, Tomba is usually the top choice.
Nuno PoçoSales Automation Architect, clickworks.ioThe data is always fresh, and the n8n integration is excellent. Support is very responsive. I'd rate it 9/10.
Benjie MalinaoCo-Founder & CTO, Channel Automation