Skip to main content

Bulk Email Finder

Swiftly obtain email addresses from a list of names and companies using Bulk Email Finder

Written by Tomba.io Team

Bulk Email Finder Guide

Find thousands of professional email addresses in one go by uploading your list of names and companies.


Getting Started

  1. Navigate to the Bulks page

  2. Click on Email Finder

  3. Select + New Bulk, name your task, and upload your file

📄 Accepted file formats: .CSV or .TXT
👤 Your file should contain either:

  • Three separate columns for First Name and Last Name, Website

  • or One combined column (without middle names)


Creating a New Bulk Email Finder

When you click + New Bulk, you'll see the creation form:

List Name

Give your task a unique name (3-201 characters).

Upload Your File

A CSV file is required with at least 5 rows and 2 or more columns.

Column Mapping

After uploading, a preview table shows the first 10 rows. Map your columns:

  • First Name column (or Full Name if combined)

  • Last Name column (if separate from first name)

  • Domain / Company Website column

  • Company Name column (alternative to domain)

You must provide either (First Name + Last Name) or Full Name, AND either Domain or Company Name.

Options

  • Skip rows with existing emails — Toggle to skip rows that already contain an email address

  • Include sources — Toggle to include the source URLs where each email was found

  • Include phone numbers — Toggle to find phone numbers for each contact

  • Notify me when ready — Toggle to receive an email notification when complete

Limits

  • Maximum: 10,000 rows per file

  • File size must not exceed 4MB

  • Minimum: 5 rows required


Processing & Results

Tomba automatically validates every email it finds. Once processing is complete, you'll get an overview of:

  • Total emails found

  • Deliverability status

You can download the results in CSV format, choosing to:

  • Export all emails, or

  • Export only valid emails


Understanding the Results File

Your downloaded file will include all your original columns plus these new ones:

CSV Column

Description

First Name

Contact's first name

Last Name

Contact's last name

Email address

The email address found by Tomba

Confidence score

Deliverability likelihood (percentage)

Verification status

Valid, Accept all, Invalid, or Unknown

Phone to Phone10

Up to 10 phone numbers (if phone enabled)

If you enabled Sources, the CSV will also include Total Sources and Source1 through Source10.


Tips for Best Results

✅ Use the company’s domain instead of its full name
✅ Maximum of 10,000 rows per file (extra rows will be ignored)
✅ Avoid special characters in your data
✅ File size must not exceed 4MB


Viewing Task Results

Click on any task to view its detail page.

Progress Tracking

While your task is running:

  • A progress bar shows the percentage completed

  • A live counter displays items processed vs total

  • Your browser tab shows progress in the favicon

  • Click the bell icon to enable desktop notifications

Results Preview

Once completed, a preview table shows the first rows of results with columns:

  • Email — The email address found

  • Score — Confidence percentage with color-coded bar

  • Result — Verification status (Valid, Invalid, Accept all, Unknown)

Download Options

Click Download to choose:

  • Full list — All results including not-found rows

  • Valid only — Only verified valid email addresses

Task Details

A details grid displays:

  • Created and Expiration dates

  • Processing duration

  • Total emails found

  • Search cost in credits (consumed on download)

Task Actions

From the dropdown menu: Rename, Archive (or Restore), Delete.


Managing Your Bulk Tasks

You can easily manage your uploaded bulks with these features:

  • Sort: By task name, status, or creation date

  • Search: Locate specific tasks by name

  • Filter: Toggle between All and Archived tasks

  • Rename: Change task names via the dropdown menu

  • Archive: Move completed tasks to the archive for a cleaner view

  • Restore: Bring archived tasks back to the active list

  • Delete: Remove tasks permanently via the dropdown menu

  • Pagination: Choose how many tasks to display per page (10, 20, 50, 100, 150, or 200)


LinkedIn Email Finder for Microsoft Excel

Tomba’s Excel Add-on helps you extract professional email addresses using LinkedIn profile URLs directly within Excel.

How to Use It:

  1. Open your Excel file containing contact data.
    Ensure the file includes at least the following columns:

    • First Name

    • Last Name

    • Company Name or Domain Name
      ​(For best results, include all four fields.)

  2. Navigate to the Finder tab in the Tomba Excel Add-on.

  3. Map your columns to the corresponding contact fields.

  4. If your table has headers, check the "My table has headers" box.

  5. Click "Find email addresses" to start enriching your contacts.


Enrich Your Data with Email Addresses Using the Google Sheets Add-on

Tomba’s Google Sheets Add-on helps you enrich your contact list by finding professional email addresses using the first name, last name, and either the company name or domain name.

How to Use It:

  1. Open your Google Sheet containing your contacts.
    Your sheet should include at least:

    • First Name

    • Last Name

    • Company Name or Domain Name
      ​(For the best accuracy, include all four fields.)

  2. Go to the Finder tab in the Tomba add-on.

  3. Match your columns to the required contact fields.

  4. Check the "My table has headers" box if your sheet includes header rows.

  5. Click "Find email addresses".

What Happens Next:

  • Tomba will populate the sheet with the email addresses found for each contact.

  • Two new columns will be added:

    • Confidence Score – indicating the accuracy of the match.

    • Status – showing the result of the search.

Possible Statuses:

  • OK – A valid email address was found.

  • No results – No email address could be found.

  • Parameter(s) missing – Required fields (first name, last name, company/domain) were missing and the lookup couldn’t be completed.


Using The Email Finder via API

Generates or retrieves the most likely email address from a domain name, a first name and a last name.

from tomba.client import Clientfrom tomba.services.finder import Finder# Initialize the Tomba clientclient = Client()client.set_key('ta_xxxx').set_secret('ts_xxxx')# Initialize the Email Finder servicefinder = Finder(client)# Find the email address for a specific personresult = finder.email_finder('stripe.com', 'fname', 'lname')

Available SDKs

Tomba offers official SDKs for many popular programming languages, including:
​PHP, Python, C#, Go, Rust, Ruby, Dart, JavaScript, R, Lua, Elixir, and more.


Task Progress Tracking

While your bulk task is processing:

  • A progress bar shows the percentage completed

  • A live counter displays items processed vs total items

  • Your browser tab updates with the progress percentage in the favicon

  • Click the bell icon to enable desktop notifications — you’ll be notified when your task finishes


Task Statuses

Each bulk task goes through one of the following statuses:

  • Pending — Task is queued, not yet started

  • Running — Currently being processed

  • Completed — Results are ready to download

  • No Result — Completed but no results were found

  • Failed — Task terminated with an error

  • Cancelled — Stopped by user or system

  • Expired — Data retention period has passed, results are no longer available


Task Details

Each completed task displays:

  • Created date and expiration date

  • Processing duration

  • Total results found

  • Total items processed

  • Verification status and cost (if verification was enabled)

  • Search cost in credits


Credits & Upgrade

  • Credits are only consumed when you download the results

  • If you don’t have enough credits, an upgrade prompt will appear with a link to upgrade your plan

  • Team members will see a notice if the team owner needs more credits



Related Resources

Did this answer your question?