Skip to content
Tomba home
Start free

// developer platform

Powerful API for Email Intelligence

Build email finding, verification, and enrichment into your applications. RESTful API with SDKs for all major languages.

Get free API keyAPI reference
api.tomba.io/v1X-Tomba-Key · X-Tomba-SecretOpenAPI 3
GETapi.tomba.io/v1/domain-search
Example response from the API reference
organization.organization
Pied Piper
organization.industries
computer software
organization.company_size
11-50
organization.pattern
{first}
organization.accept_all
false
emails
2 items
emails[0].email
dinesh@piedpiper.com
emails[0].position
Software Engineer
emails[0].verification.status
valid

// 01 · endpoints

Every endpoint, its cost and its reference page

REST over HTTPS, JSON in and out, two headers for authentication. Base URL https://api.tomba.io/v1.

GET/email-finderA person's work email from their name and company domain1 search creditAn address is returned with a status other than unknown. 6 with phone data.
GET/domain-searchThe email addresses at a company, with names, roles and the company profile1 per 10 search creditsAt least one address is returned. 1 credit per 10 results requested with limit.
GET/email-verifierWhether an address is deliverable: syntax, MX, SMTP, catch-all and greylisting checks1 verification creditThe status is not disposable or unknown.
GET/enrichThe person behind an email address: name, role, company and profiles1 search creditAn address is returned with a status other than unknown. 6 with phone data.
GET/linkedinThe work email of the person behind a LinkedIn profile URL1 search creditAn address is returned. 6 with phone data.
GET/author-finderThe email of the person who wrote an article1 search creditAn address is returned.
GET/phone-finderA person's phone number from their email, domain or LinkedIn URL5 search creditsA valid number is returned. 1 when the request includes domain.
GET/phone-validatorWhether a phone number is valid, its line type, carrier and region1 search creditEvery successful response, including one with no data.
POST/reveal/searchCompanies that match a plain-language query or filters1 search creditPer request, when at least one company is returned.
GET/combined/findThe person and their company from one email address2 search creditsA person is returned.
GET/companies/findA company profile from its domain: industry codes, size, location, socials1 search creditA company is returned.
GET/technologyThe technologies a website runs, by categoryFreeNot charged; needs a positive search balance.
GET/email-countHow many addresses Tomba holds for a domain, by department and seniority1 email count creditEvery call.
GET/similarCompanies similar to a domain, with their industry1 per 10 search creditsResults are returned. 1 credit per 10 results requested with limit.
GET/email-formatThe address patterns a company uses, with their share1 email count creditEvery successful call, including an empty result.
GET/locationWhere a company's people are, by country1 email count creditEvery successful call, including an empty result.
GET/people/findA person profile from a work email: name, employment, location, social handles1 search creditA person is returned.
Base URL https://api.tomba.io/v1 · Send X-Tomba-Key and X-Tomba-Secret with every request.Every endpoint in the API reference

// 02 · bulk

Bulk jobs for lists of up to 25,000 rows

POST a list, rows or a CSV to /bulk/, get a signed webhook when it ends, and pay once at the first download.

TypeInputMax rows
POST/bulk/searchDomains or company names25,000
POST/bulk/similarDomains or company names5,000
POST/bulk/companyDomains or company names25,000
POST/bulk/finderNames, with a domain or company name10,000
POST/bulk/enrichEmail addresses20,000
POST/bulk/linkedinLinkedIn profile URLs20,000
POST/bulk/authorArticle URLs5,000
POST/bulk/verifierEmail addresses20,000
POST/bulk/phone-finderEmail addresses, LinkedIn URLs or domains10,000
POST/bulk/phone-validatorPhone numbers, with an optional country10,000

// 03 · rate limits

Throughput by plan

Limits are per account across all its keys. Bulk jobs have their own limits.

// rate limits

Requests per second / minute / day
FreeBasicGrowthPro
Search, finder, similar, technology1 / 2 / 53 / 50 / 5005 / 80 / 1,0008 / 150 / 4,000
Email verifier1 / 2 / 102 / 40 / 5003 / 60 / 1,0005 / 100 / 4,000

Pro Plus, Scale and credit packs of 50,000 or more: no limit on these endpoints. Enterprise: no per-second or per-minute limit, 100,000 requests a day. Daily limits reset at 00:00 UTC. Rate limits

// 04 · sdks and tools

13 SDKs, a CLI and an MCP server

Official libraries wrap the same endpoints; the CLI and the MCP server use your key or OAuth.

Python
pip install tomba-io
Node.js
npm install tomba
PHP
composer require tomba-io/php
Ruby
gem install tomba
Go
go get github.com/tomba-io/go
C#
dotnet add package Tomba
Rust
cargo add tomba
Deno
deno add jsr:@tomba/sdk
Dart
dart pub add tomba
Elixir
{:tomba, "~> 1.0"}
Lua
luarocks install tomba
Perl
cpanm Tomba::Finder
R
remotes::install_github("tomba-io/r")
Full API documentation View on GitHub MCP Server

// faqs

API FAQs

Still have questions? Visit the help center

// quick start

Make your first call in a minute

Free account, real API key, the same endpoints Enterprise customers use.

  1. 1Create a free account25 searches a month. No card.
  2. 2Copy your key and secretFrom API keys in the dashboard.
  3. 3Call the APIPaste the request; the answer is JSON.
Get free API keyRead the docs
curl "https://api.tomba.io/v1/email-finder?domain=piedpiper.com&first_name=Richard&last_name=Hendricks" \
  -H "X-Tomba-Key: $TOMBA_API_KEY" \
  -H "X-Tomba-Secret: $TOMBA_SECRET_KEY"
Response
200 OK· 1 search credit
{
  "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": []
  }
}