// bulkbewerkingen
Bulk Vergelijkbare Domeinen
Upload een CSV met domeinen en vind vergelijkbare bedrijven voor elk domein tegelijk.
- 01pending
POST /v1/bulk/similar201 · { "data": { "id": 1042 } } - 02running
launch: truevoortgang opgevraagd met GET /v1/bulk/similar/1042/progress - 03completed
bulk.completedondertekende webhook afgeleverd op je webhook_url
GET /v1/bulk/similar/1042/download?file=fullIn rekening gebracht bij de eerste download · de taak verloopt na 180 dagen// 01 · invoer
De invoer van een Similar Domains-bulktaak
Upload in de app een CSV van maximaal 4 MB, of stuur een lijst, rijen of een bestand naar POST /v1/bulk/similar. Kolommen worden herkend aan de kopregel; stel een veldindex in om er zelf een te kiezen.
/bulk/similarKolommendomain_field_index- Domain
company_name_field_index- Company name
/bulk/similarOptiesinput_type- domain or company; company when the input has a company name column and no domain column
max_emails_per_domain- Addresses per domain: 1, 10 (the default), 20, 50 or 100
// 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 /similar teruggeeft.
curl -X POST "https://api.tomba.io/v1/bulk/similar" \
-H "X-Tomba-Key: $TOMBA_API_KEY" \
-H "X-Tomba-Secret: $TOMBA_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"Similar Domains job","list":"piedpiper.com\nshopify.com","launch":true,"webhook_url":"https://hooks.example.com/tomba"}'const res = await fetch("https://api.tomba.io/v1/bulk/similar", {
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": "Similar Domains job",
"list": "piedpiper.com\nshopify.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/similar",
headers={
"X-Tomba-Key": os.environ["TOMBA_API_KEY"],
"X-Tomba-Secret": os.environ["TOMBA_SECRET_KEY"],
},
json={
"name": "Similar Domains job",
"list": "piedpiper.com\nshopify.com",
"launch": True,
"webhook_url": "https://hooks.example.com/tomba"
},
)
job_id = res.json()["data"]["id"]{
"data": {
"id": 1042
}
}{
"data": [
{
"website_url": "hooli.com",
"name": "Hooli",
"industries": "internet"
},
{
"website_url": "endframe.com",
"name": "Endframe",
"industries": "computer software"
}
],
"meta": {
"total": 2,
"pageSize": 10,
"current": 1,
"total_pages": 1,
"params": {
"domain": "piedpiper.com",
"page": 1,
"limit": 10
}
}
}// 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 domain with at least one similar company.
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 Similar Domains-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/domain-similar
// klanten
Teams die Similar Domains-taken uitvoeren
We use Tomba to find emails of the right people, helping us reach out and grow our network easily.
Olderico A.F. CavigliaCEO, StrategycappSince years, Tomba has provided the most results per search, and it keeps getting better. It recently became one of the most feature-rich tools for our list building.
Steffen BurandtHead of Business Development, Chandler Orchards