// bulkbewerkingen
Bulk E-mailverificatie
Upload een CSV met e-mailadressen en verifieer ze allemaal op afleverbaarheid tegelijk.
- 01pending
POST /v1/bulk/verifier201 · { "data": { "id": 1042 } } - 02running
launch: truevoortgang opgevraagd met GET /v1/bulk/verifier/1042/progress - 03completed
bulk.completedondertekende webhook afgeleverd op je webhook_url
GET /v1/bulk/verifier/1042/download?file=fullIn rekening gebracht bij de eerste download · de taak verloopt na 180 dagen// 01 · invoer
De invoer van een Email Verifier-bulktaak
Upload in de app een CSV van maximaal 4 MB, of stuur een lijst, rijen of een bestand naar POST /v1/bulk/verifier. Kolommen worden herkend aan de kopregel; stel een veldindex in om er zelf een te kiezen.
/bulk/verifierKolommenemail_field_index- Email address
/bulk/verifierOptiesfind_phones- true adds phone numbers, at an extra cost
include_sources- true adds the web pages where each address was found
// 02 · api
Eén verzoek start de taak
Maak en start de taak in één aanroep, volg daarna de voortgang of ontvang een ondertekend bulk.completed-event. Elke resultaatrij is wat GET /email-verifier teruggeeft.
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 en limieten
Wat een taak kost
Een taak aanmaken of starten kost niets. De kosten worden één keer in rekening gebracht, bij de eerste download van de resultaten.
// facturering per rij
1 verification credit per row, except disposable addresses. Plus 5 search credits per row with phone data.
Bulkfacturering in de documentatie- Rijen: tot 20,000 per taak
- 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 · overal te gebruiken
Voer Email Verifier-taken uit vanuit de app of je code
Dezelfde taak, dezelfde credits: upload een bestand in de app, roep de API aan of werk vanuit een spreadsheet of een no-code-tool.
- REST APIJSON via HTTPS, 13 SDK's, ondertekende webhooks.
GET /v1/email-finder - Bulk-CSVUpload een lijst in de app of POST hem naar /bulk; download als hij klaar is.
POST /v1/bulk/{type} - Google Sheets en ExcelFormules en een zijbalk die dezelfde endpoints aanroepen.
=TOMBA_VERIFY(A2) - Zapier, Make, n8nNo-code-acties voor de finder, de verifier en verrijking.
Zapier · Make · n8n · Pipedream
De volledige naslag van het verzoek: /api/bulk/email-verifier
// klanten
Teams die Email Verifier-taken uitvoeren
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