Tomba.io is an Email Finder for B2B sales and email marketing
npm install tombaOfficial Node.js client for the Tomba.io Email Finder API. Use it to:
- Domain Search (Search emails are based on the website You give one domain name and it returns all the email addresses found on the internet.)
- Email Finder (Generate or retrieve the most likely email from a domain/company and name.)
- Email Verifier (checks the deliverability of a given email address, verifies if it has been found in our database, and returns their sources.)
- Email Enrichment (Locate and include data in your emails.)
- Author Finder (Instantly discover the email addresses of article authors.)
- LinkedIn Finder (Instantly discover the email addresses of Linkedin URLs.)
- Reveal (Find relevant companies at scale.)
- Phone Finder (Search phone numbers based on email address, website, or LinkedIn profile URL.)
- Phone Validator (Validate phone numbers & check carrier information.)
You'll need a Tomba API access token, which you can get by signing up for a free account at https://app.tomba.io/auth/register.
The free plan is limited to 25 search requests and 50 verifications per month. For higher limits see https://tomba.io/pricing.
To install via NPM:
``bash`
npm install tomba --save
To install via YARN:
`bash`
yarn add tomba
Tomba supports TypeScript out of the box. Use ES6 imports with full type safety and autocompletion.
#### Example
`ts
import { TombaClient, Domain } from "tomba";
// Init Tomba
const client = new TombaClient();
const domain = new Domain(client);
client
.setKey("ta_xxxx") // Your Key
.setSecret("ts_xxxx"); // Your Secret
const result = domain.domainSearch({
domain: "stripe.com",
// or company: "stripe"
page: 1,
limit: "10",
country: "US",
department: "engineering",
});
result
.then((response) => {
console.log(response);
})
.catch((err) => {
console.log(err);
});
`
See more TypeScript examples in examples/README.md.
Find the verified email address of any professional.
`ts
import { TombaClient, Finder } from "tomba";
// Init Tomba
const client = new TombaClient();
const finder = new Finder(client);
client
.setKey("ta_xxxx") // Your Key
.setSecret("ts_xxxx"); // Your Secret
const result = finder.emailFinder({
domain: "stripe.com", // or company: "stripe"
fullName: "John Doe", // or firstName + lastName
enrichMobile: true,
});
result
.then((response) => {
console.log(response);
})
.catch((err) => {
console.log(err);
});
`
Verify the validity of any professional email address with the most complete email checker.
`js
import { TombaClient, Verifier } from "tomba";
// Init Tomba
let client = new TombaClient();
let verifier = new Verifier(client);
client
.setKey("ta_xxxx") // Your Key
.setSecret("ts_xxxx"); // Your Secret
let result = verifier.emailVerifier("b.mohamed@tomba.io");
result
.then((response) => {
console.log(response);
})
.catch((err) => {
console.log(err);
});
`
Sample code lives under examples/README.md.
See the official documentation.
There are official Tomba Email Finder client libraries available for many languages including PHP, Python, Go, Java, Ruby, and many popular frameworks such as Django, Rails and Laravel. There are also many third party libraries and integrations available for our API.
https://docs.tomba.io/libraries
Founded in 2020, Tomba prides itself on being the most reliable, accurate, and in-depth source of Email address data available anywhere. We process terabytes of data to produce our Email finder API, company.

1. Fork it (
2. Create your feature branch (git checkout -b my-new-feature)git commit -am 'Add some feature'
3. Commit your changes ()git push origin my-new-feature`)
4. Push to the branch (
5. Create a new Pull Request
Please see the Apache 2.0 license file for more information.