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

Zapier

Information Services · 251-1K · San Francisco

automation that moves everyone forward. zapier is on a mission to make automation work for everyone. with zapier, you can integrate apps like salesforce, intuit, google, and dropbox, to move data between them automatically, so you can focus on your most important work. we’re 100% remote with teammates spanning 40 countries around the world. we’re hiring! try for free today: http://ow.ly/lvav50k0kqn

Founded
2011
Company type
privately held
Revenue
$10M-$50M
Location
San Francisco, California, US
Catch-all domain
Yes
Phone available
Yes
Similar companies
21
Domain registered
2011
business web applicationsintegrationsmaking magicapis

681 addresses at this domain

  • simon.charette@zapier.com

    Simon Charette · product engineer

    99valid

  • kaveh@zapier.com

    Kaveh M · Head of Customer Acquisition

    52

  • emily.harris@zapier.com

    Emily Harris · Software Engineer

    99valid

  • cortney.hickey@zapier.com

    Cortney Hickey · Executive Business Partner to the CEO

    51

  • aleks.ozolins@zapier.com

    Aleks Ozolins

    99valid

// 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 domainCost:1 search creditCharged when:An address is returned with a status other than unknown; 6 search credits instead of 1 with phone data (enrich_mobile).
GET/domain-searchThe email addresses at a company, with names, roles and the company profileCost:1 search credit per 10 resultsCharged when:At 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 checksCost:1 verification creditCharged when:The status is not disposable or unknown. Phone numbers returned with enrich_mobile cost 5 search credits each, from the search allowance.
GET/enrichThe person behind an email address: name, role, company and profilesCost:1 search creditCharged when:An address is returned with a status other than unknown; 6 search credits instead of 1 with phone data (enrich_mobile).
GET/linkedinThe work email of the person behind a LinkedIn profile URLCost:1 search creditCharged when:An address is returned; 6 search credits instead of 1 with phone data (enrich_mobile).
GET/author-finderThe email of the person who wrote an articleCost:1 search creditCharged when:An address is returned.
GET/phone-finderA person's phone number from their email, domain or LinkedIn URLCost:5 search creditsCharged when:A valid number is returned; 1 search credit instead of 5 when you search by domain.
GET/phone-validatorWhether a phone number is valid, its line type, carrier and regionCost:1 search creditCharged when:Every successful response, including one with no data.
POST/reveal/searchCompanies that match a plain-language query or filtersCost:1 search creditCharged when:At least one company is returned.
GET/combined/findThe person and their company from one email addressCost:2 search creditsCharged when:A person is returned.
GET/companies/findA company profile from its domain: industry codes, size, location, socialsCost:1 search creditCharged when:A company is returned.
GET/technologyThe technologies a website runs, by categoryCost:FreeCharged when:Not charged; needs a positive search balance.
GET/email-countHow many addresses Tomba holds for a domain, by department and seniorityCost:1 email count creditCharged when:Every call.
GET/similarCompanies similar to a domain, with their industryCost:1 search credit per 10 resultsCharged when:Results are returned. 1 credit per 10 results requested with limit.
GET/email-formatThe address patterns a company uses, with their shareCost:1 email count creditCharged when:Every successful call, including an empty result.
GET/locationWhere a company's people are, by countryCost:1 email count creditCharged when:Every successful call, including an empty result.
GET/people/findA person profile from a work email: name, employment, location, social handlesCost:1 search creditCharged when:A 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.

Bulk 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

Scroll sideways for every column

// 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

Scroll sideways for every column

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.

// 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. 01Create a free account25 search credits every 30 days. No card.
  2. 02Copy your key and secretFrom API keys in the dashboard.
  3. 03Call the APIPaste the request; the answer is JSON.
Get free API keyRead the docs
curl -G https://api.tomba.io/v1/email-finder \
  --data-urlencode "domain=piedpiper.com" \
  --data-urlencode "first_name=Richard" \
  --data-urlencode "last_name=Hendricks" \
  -H "X-Tomba-Key: $TOMBA_API_KEY" \
  -H "X-Tomba-Secret: $TOMBA_SECRET_KEY"
Response
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": []
  }
}