// bulkbewerkingen
Bulk E-mailverrijking
Upload een CSV met e-mailadressen en verrijk ze allemaal met contact- en bedrijfsgegevens tegelijk.
- 01pending
POST /v1/bulk/enrich201 · { "data": { "id": 1042 } } - 02running
launch: truevoortgang opgevraagd met GET /v1/bulk/enrich/1042/progress - 03completed
bulk.completedondertekende webhook afgeleverd op je webhook_url
GET /v1/bulk/enrich/1042/download?file=fullIn rekening gebracht bij de eerste download · de taak verloopt na 180 dagen// 01 · invoer
De invoer van een Email Enrichment-bulktaak
Upload in de app een CSV van maximaal 4 MB, of stuur een lijst, rijen of een bestand naar POST /v1/bulk/enrich. Kolommen worden herkend aan de kopregel; stel een veldindex in om er zelf een te kiezen.
/bulk/enrichKolommenemail_field_index- Email address
/bulk/enrichOptiesfind_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 /enrich teruggeeft.
curl -X POST "https://api.tomba.io/v1/bulk/enrich" \
-H "X-Tomba-Key: $TOMBA_API_KEY" \
-H "X-Tomba-Secret: $TOMBA_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"Email Enrichment job","list":"richard@piedpiper.com","launch":true,"webhook_url":"https://hooks.example.com/tomba"}'const res = await fetch("https://api.tomba.io/v1/bulk/enrich", {
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 Enrichment job",
"list": "richard@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/enrich",
headers={
"X-Tomba-Key": os.environ["TOMBA_API_KEY"],
"X-Tomba-Secret": os.environ["TOMBA_SECRET_KEY"],
},
json={
"name": "Email Enrichment job",
"list": "richard@piedpiper.com",
"launch": True,
"webhook_url": "https://hooks.example.com/tomba"
},
)
job_id = res.json()["data"]["id"]{
"data": {
"id": 1042
}
}{
"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
}
],
"disposable": false,
"webmail": false,
"phone_data": []
}
}// 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 search credit per row with a result. Plus 5 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 Enrichment-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-enrichment
// klanten
Teams die Email Enrichment-taken uitvoeren
I've been using Tomba.io for nearly three years. I've run multiple side-by-side tests against other tools and Hunter. Tomba.io delivered better results every time.
Aristotle MalichettyBusiness Intelligence AnalystTomba.io is very fast with lots of features. I run leads from Apollo into Tomba and grab prospect info in record time. I'm saving at least 5 hours a week. No joke.
Julian M.Account Executive, Insight