// for developers
Build email intelligence into anything you ship
13 SDKs. REST API. MCP server. CLI. Full docs. Install with one command and start enriching contacts from your code in 3 minutes.
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"const params = new URLSearchParams({
domain: "piedpiper.com",
first_name: "Richard",
last_name: "Hendricks"
});
const res = await fetch(`https://api.tomba.io/v1/email-finder?${params}`, {
headers: {
"X-Tomba-Key": process.env.TOMBA_API_KEY,
"X-Tomba-Secret": process.env.TOMBA_SECRET_KEY
}
});
const { data } = await res.json();import os, requests
res = requests.get(
"https://api.tomba.io/v1/email-finder",
params={
"domain": "piedpiper.com",
"first_name": "Richard",
"last_name": "Hendricks",
},
headers={
"X-Tomba-Key": os.environ["TOMBA_API_KEY"],
"X-Tomba-Secret": os.environ["TOMBA_SECRET_KEY"],
},
)
data = res.json()["data"]// teams at these companies use tomba
// 01 · workflow
Every endpoint, its cost and its reference
REST over HTTPS, two headers for authentication, JSON back. The SDKs, the CLI and the MCP server make the same calls.
https://api.tomba.io/v1 · Send X-Tomba-Key and X-Tomba-Secret with every request.Every endpoint in the API reference // 02 · features
The developer experience you deserve
We obsess over DX so you can obsess over your product. Install, authenticate, and ship: all in under 5 minutes.
13 official SDKs
C#, Dart, Deno, Elixir, Go, Lua, Node.js, Perl, PHP, Python, R, Ruby and Rust. One-command install. All maintained and open-source on GitHub.
Limits you can plan for
Rate limits are published per plan and endpoint, and GET /v1/rate-limits returns the ones that apply to your account.
MCP server for AI
Connect Tomba to Claude, Cursor, Windsurf, and any MCP-compatible AI tool. Your AI assistant finds and verifies emails natively.
CLI for automation
tomba find, tomba verify, tomba search: pipe results to scripts, cron jobs, CI/CD pipelines. Perfect for automation workflows.
Bulk & async APIs
Submit batch jobs with thousands of records. Get webhook notifications when done. No polling, no timeouts.
Docs that don't suck
API reference, quickstart guides, code examples for every language, Postman collection, and OpenAPI spec. Copy-paste and go.
// 03 · tools
The tools this team uses
- Email finder APIFind emails by name and company programmatically.
- Domain search APIGet all emails for a domain via API.
- Verifier APIVerify emails in real-time from your app.
- MCP serverLet AI tools call Tomba directly.
- CLI toolFind emails from your terminal.
- Bulk APIsProcess thousands of records asynchronously.
// 04 · customers
What customers say
I've tested over a dozen email finder tools, and Tomba.io stands out as the best. It consistently delivers accurate results and is incredibly easy to set up using the API key.
Andrei KholkinFounder, Superpage.ioThe data is always fresh, and the n8n integration is excellent for my use case. Support is very responsive overall. I'd rate it 9/10.
Benjie MalinaoCo-Founder & CTO, Channel AutomationTomba.io is very fast and has lots of features to help anyone prospect and find exactly who you need to find. I use my zoom.info and Apollo to find companies for lead gen and then run those leads into tomba to grab me prospect info in record time.
Julian M.Account Executive, Insightvia G2As a Founder, as well as a sales leader, there are three things that are important to me when I choose an email finder solution. It's got to be cost effective, easy to use and of course the data has to be accurate, I actively recommend it.
Kevin DixonFounder, Boxxstep