// bulkbewerkingen
Bulk Auteur Zoeken
Upload een CSV met artikel-URL's en vind alle e-mailadressen van auteurs tegelijk.
- 01pending
POST /v1/bulk/author201 · { "data": { "id": 1042 } } - 02running
launch: truevoortgang opgevraagd met GET /v1/bulk/author/1042/progress - 03completed
bulk.completedondertekende webhook afgeleverd op je webhook_url
GET /v1/bulk/author/1042/download?file=fullIn rekening gebracht bij de eerste download · de taak verloopt na 180 dagen// 01 · invoer
De invoer van een Author Finder-bulktaak
Upload in de app een CSV van maximaal 4 MB, of stuur een lijst, rijen of een bestand naar POST /v1/bulk/author. Kolommen worden herkend aan de kopregel; stel een veldindex in om er zelf een te kiezen.
/bulk/authorKolommenurl_field_index- Article URL
/bulk/authorOptiesinclude_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 /author-finder teruggeeft.
curl -X POST "https://api.tomba.io/v1/bulk/author" \
-H "X-Tomba-Key: $TOMBA_API_KEY" \
-H "X-Tomba-Secret: $TOMBA_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"Author Finder job","list":"https://piedpiper.com/blog/middle-out-compression","launch":true,"webhook_url":"https://hooks.example.com/tomba"}'const res = await fetch("https://api.tomba.io/v1/bulk/author", {
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": "Author Finder job",
"list": "https://piedpiper.com/blog/middle-out-compression",
"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/author",
headers={
"X-Tomba-Key": os.environ["TOMBA_API_KEY"],
"X-Tomba-Secret": os.environ["TOMBA_SECRET_KEY"],
},
json={
"name": "Author Finder job",
"list": "https://piedpiper.com/blog/middle-out-compression",
"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
}
],
"info": {
"url": "https://piedpiper.com/blog/middle-out-compression",
"title": "Middle-out compression, explained",
"og_image": "https://piedpiper.com/blog/middle-out-compression/cover.png",
"description": "How middle-out compression reached a Weissman score of 5.2.",
"article_domain": "piedpiper.com",
"publisher_name": "Pied Piper",
"publish_date": "2025-03-04",
"candidates": [
{
"full_name": "Richard Hendricks",
"first_name": "Richard",
"last_name": "Hendricks",
"job_title": "CEO",
"linkedin": "https://www.linkedin.com/in/richard-hendricks",
"name_confidence": 0.98,
"score": 0.95,
"count": 3
}
]
}
}
}// 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 article with an author address.
Bulkfacturering in de documentatie- Rijen: tot 5,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 Author Finder-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/author-finder
// klanten
Teams die Author Finder-taken uitvoeren
Tomba finding the contacts for the perfect prospects at scale is game changing in helping us promote our data-based research studies.
Nicholas RizzoSenior Digital Manager, VizmeTomba has been critical to my SEO and cold outreach workflow. None matched Tomba's accuracy or the depth of contact details it returns.
Henry HoeSEO & Sales Outreach Specialist