// post /v1/bulk/verifier
Massen-E-Mail-Verifizierungs-API
Bereinigen und bewerten Sie E-Mail-Listen mit hohem Volumen mit einer asynchronen Verifizierungspipeline, die für Absender in großem Maßstab entwickelt wurde.
Email addressesBis zu 20,000 Zeilen
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"]// 01 · anfrage
Massen-Email Verifier 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
- verifier
- list | data | file
- Email addresses
- launch
- true startet den Job sofort
- webhook_url
- Erhält ein signiertes Ereignis, wenn der Job endet
- rows
- Bis zu 20,000 pro Job
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"]// 02 · antwort
Was zurückkommt
JSON, in jeder Sprache gleich. Felder, die Tomba nicht kennt, sind null und werden nie geraten.
GET
/email-verifierdata.email.resultstring- deliverable, risky or undeliverable; empty for a disposable domain
data.email.statusstring- valid, accept_all, invalid, unknown or disposable (compare case-insensitively: a live check can return Valid)
data.email.scoreinteger- Confidence: 99 for valid, 77 or more for accept_all, 2 for disposable
data.email.smtp_providerstring | null- Mail provider from the MX records, such as Google
data.email.mx.recordsarray | null- The domain's MX hosts
data.email.mx_check, data.email.smtp_checkboolean- The domain has MX records (smtp_check is the same check; status says whether the mailbox exists)
data.email.accept_all, data.email.greylisted, data.email.blockboolean- Catch-all domain, check deferred, check refused by the server
data.email.disposable, data.email.webmail, data.email.gibberish, data.email.regexboolean- Disposable or webmail domain, random-looking address, valid syntax
data.sources[]array- Where the address was found
data.phone_data[]array | null- Phone numbers, when you send enrich_mobile
POST /bulk/verifier
201 Created
{
"data": {
"id": 1042
}
}Jede Zeile, wie GET /email-verifier sie zurückgibt
200 OK
{
"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 Aufruf kostet
Ein Aufruf wird nur unter der unten genannten Bedingung berechnet. Die Rate Limits hängen von Ihrem Tarif ab.
// kosten
1 verification credit per row, except disposable addresses. Plus 5 search credits 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 eine Liste mit E-Mail-Adressen hochladen und dann den Vorgang starten. Die API überprüft alle E-Mails asynchron mithilfe mehrschichtiger Prüfungen. Verwenden Sie Webhooks oder Umfragen, um den Fortschritt zu überwachen.
Sie können bis zu 100.000 E-Mail-Adressen pro Massenvorgang verifizieren. Erstellen Sie für größere Listen mehrere Massenvorgänge.
Jede E-Mail wird einer Syntaxvalidierung, MX-Eintragsprüfungen, SMTP-Verifizierung, Einwegerkennung, Catch-All-Erkennung und Zustellbarkeitsbewertung unterzogen.
Wenn eine Adresse, die Tomba als gültig geliefert hat, einen Hard Bounce erzeugt, erhalten Sie den Credit im Rahmen der Datenqualitätsgarantie zurück (Verifier-Ergebnis deliverable oder Finder-Wert von 60 oder mehr, gesendet innerhalb von 30 Tagen von einer Domain mit SPF, DKIM und DMARC).
Die Geschwindigkeit hängt von der Größe der Liste und davon ab, wie schnell jeder Mailserver antwortet. 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 Verifizierungsstatus (gültig, ungültig, alle akzeptieren, unbekannt), den Konfidenzwert, das Wegwerfkennzeichen, den SMTP-Anbieter und MX-Einträge.
Sobald die Verarbeitung abgeschlossen ist, verwenden Sie den Download-Endpunkt, um Ergebnisse als CSV oder JSON zu erhalten. Die Ergebnisse umfassen alle Verifizierungsdaten für jede E-Mail.
Ja, konfigurieren Sie eine Webhook-URL, um Benachrichtigungen zu erhalten, wenn Ihre Massenüberprüfung abgeschlossen ist oder wenn bei der Verarbeitung Fehler auftreten.
Alle-Akzeptanz-Domänen können gültig, aber riskanter sein. Priorisieren Sie höhere Konfidenzwerte und erwägen Sie segmentierte Sendestrategien für diese Datensätze.
Überprüfen Sie Listen kurz vor dem Versand, unterdrücken Sie ungültige und nicht verfügbare Adressen und überprüfen Sie ältere Listen regelmäßig erneut, um die Zustellbarkeit aufrechtzuerhalten.