// bulk operations
Bulk Email Finder
Upload a CSV of names and domains to find all the professional email addresses at once.
Names, with a domain or company nameUp to 10,000 rows a jobCSV, list or rows
email-finder-list.csv2,500 rows · names, with a domain or company namecompleted
Bulk Email Finder · /bulk/finder2,500 / 2,500
- 01pending
POST /v1/bulk/finder201 · { "data": { "id": 1042 } } - 02running
launch: trueprogress polled with GET /v1/bulk/finder/1042/progress - 03completed
bulk.completedsigned webhook delivered to your webhook_url
GET /v1/bulk/finder/1042/download?file=fullCharged at the first download · the job expires after 180 days// 01 · input
The input of a bulk Email Finder job
Upload a CSV of up to 4 MB in the app, or send a list, rows or a file to POST /v1/bulk/finder. Columns are found from the header row; set a field index to choose one yourself.
POST
/bulk/finderColumnsdomain_field_index- Domain
company_name_field_index- Company name
first_name_field_index, last_name_field_index- First name, last name
full_name_field_index- Full name
POST
/bulk/finderOptionsfind_phones- true adds phone numbers, at an extra cost
include_sources- true adds the web pages where each address was found
skip_rows_with_email- true skips rows that already have a value in an email column
// 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 /email-finder returns.
curl -X POST "https://api.tomba.io/v1/bulk/finder" \
-H "X-Tomba-Key: $TOMBA_API_KEY" \
-H "X-Tomba-Secret: $TOMBA_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"Conference leads","data":[["first_name","last_name","company_website"],["Richard","Hendricks","piedpiper.com"]],"launch":true,"webhook_url":"https://hooks.example.com/tomba"}'const res = await fetch("https://api.tomba.io/v1/bulk/finder", {
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": "Conference leads",
"data": [
[
"first_name",
"last_name",
"company_website"
],
[
"Richard",
"Hendricks",
"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/finder",
headers={
"X-Tomba-Key": os.environ["TOMBA_API_KEY"],
"X-Tomba-Secret": os.environ["TOMBA_SECRET_KEY"],
},
json={
"name": "Conference leads",
"data": [
[
"first_name",
"last_name",
"company_website"
],
[
"Richard",
"Hendricks",
"piedpiper.com"
]
],
"launch": True,
"webhook_url": "https://hooks.example.com/tomba"
},
)
job_id = res.json()["data"]["id"]POST /bulk/finder
201 Created
{
"data": {
"id": 1042
}
}Each row, as GET /email-finder returns it
200 OK
{
"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
}
],
"phone_data": []
}
}// 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 row whose address is verified valid. Plus 5 per row with phone data.
Bulk billing in the docs- Rows: up to 10,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 Email Finder 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_FIND(A2, B2) - Zapier, Make, n8nNo-code actions for the finder, verifier and enrichment.
Zapier · Make · n8n · Pipedream
The full request reference: /api/bulk/email-finder
// 5,000-lead benchmark
More valid emails than the eight other tools we tested
Real data. Same input. No human touch. Full transparency. We ran a head-to-head test using the same 5,000-line input file across multiple email-finding tools.
| Rank | Tool | From websites | From company names | Total |
|---|---|---|---|---|
| 1 |  Tomba.ioSites 2,026 · 81.0% Names 1,989 · 79.6% | 2,02681.0% | 1,98979.6% | 4,015 |
| 2 | 1,91876.7% | 1,95778.3% | 3,875 | |
| 3 | 1,88075.2% | 1,87775.1% | 3,757 | |
| 4 | 1,48359.3% | 1,61364.5% | 3,096 | |
| 5 | 1,00140.0% | 1,14145.6% | 2,142 | |
| 6 | 88735.5% | 99539.8% | 1,882 | |
| 7 | 1,05142.0% | 74930.0% | 1,800 | |
| 8 | 98839.5% | Under 1% found from company names: the tool needs a website or domain:190.8% | 1,007 | |
| 9 | 82433.0% | Under 1% found from company names: the tool needs a website or domain:220.9% | 846 |
Tomba.io found 4,015 valid emails from 5,000 leads: #1 of 9 tools tested.
Tomba’s own test, February 2026. One file of 5,000 leads, 2,500 with the company website and 2,500 with only the company name, ran through each tool with no manual cleanup. Only addresses a tool labelled valid or verified count; percentages are of the 2,500 inputs of each kind.
Under 1% found from company names: the tool needs a website or domain.
The Bulk Email Finder is a powerful tool designed for obtaining email addresses of professionals in large quantities. Users can input data via a CSV upload, receiving a file enriched with email addresses in return. The uploaded file should include separate or combined columns for first and last names, and a column for the company name or its website.
The Bulk Email Finder taps into a vast database of public email addresses to identify accurate contact details. Every email address undergoes a verification process. Those with a "Valid" status are confirmed as deliverable and can be used confidently. For unverified emails, a confidence score based on several criteria is provided to estimate the email's reliability.
The Email Finder's results can vary. Initially, it searches for matches in a publicly accessible database of email addresses. If no direct match is found, the tool uses other data points to predict the most probable email address. In both scenarios, the email addresses are subjected to a verification process for accuracy confirmation.
Get started with the Bulk Email Finder for free, with a limit of 25 free search credits every 30 days on a free account. For increased demand, options to upgrade your plan are available. Subscriptions can be cancelled at any time.