// bulk operations
Bulk Domain Similar
Upload a CSV of domains and find similar companies for each one at once.
- 01pending
POST /v1/bulk/similar201 · { "data": { "id": 1042 } } - 02running
launch: trueprogress polled with GET /v1/bulk/similar/1042/progress - 03completed
bulk.completedsigned webhook delivered to your webhook_url
GET /v1/bulk/similar/1042/download?file=fullCharged at the first download · the job expires after 180 days// 01 · input
The input of a bulk Similar Domains job
Upload a CSV of up to 4 MB in the app, or send a list, rows or a file to POST /v1/bulk/similar. Columns are found from the header row; set a field index to choose one yourself.
/bulk/similarColumnsdomain_field_index- Domain
company_name_field_index- Company name
/bulk/similarOptionsinput_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
One request starts the job
Create and launch it in one call, then follow its progress or receive a signed bulk.completed event. Each result row is what GET /similar returns.
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 · cost and limits
What a job costs
Nothing is charged to create or launch a job. Its cost is charged once, at the first download of its results.
// billing per row
1 search credit per domain with at least one similar company.
Bulk billing in the docs- Rows: up to 5,000 per job
- 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 · use it anywhere
Run Similar Domains jobs from the app or your code
The same job, the same credits: upload a file in the app, call the API, or work from a spreadsheet or a no-code tool.
- REST APIJSON over HTTPS, 13 SDKs, signed webhooks.
GET /v1/email-finder - Bulk CSVUpload a list in the app or POST it to /bulk; download when it's done.
POST /v1/bulk/{type} - Google Sheets and ExcelFormulas and a sidebar that call the same endpoints.
=TOMBA_VERIFY(A2) - Zapier, Make, n8nNo-code actions for the finder, verifier and enrichment.
Zapier · Make · n8n · Pipedream
The full request reference: /api/bulk/domain-similar
// customers
Teams that run Similar Domains jobs
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