// api enrichment

Enrich Contacts in Real-Time from Your Own Code

13 official SDKs, REST API, MCP server for AI tools, and CLI for automation. Get your API key free and start building in minutes.

Get Your API Key Free Read API Docs

01GET/enrichThe person behind an email address: name, role, company and profiles1 search credit
02GET/people/findA person profile from a work email: name, employment, location, social handles1 search credit
03GET/companies/findA company profile from its domain: industry codes, size, location, socials1 search credit
04GET/combined/findThe person and their company from one email address2 search credits

// teams at these companies use tomba

// 01 · workflow

The calls behind this workflow

Each step is one API call. The app, the browser extension and bulk jobs run the same endpoints, on the same credits.

GET /enrich

curl "https://api.tomba.io/v1/enrich?email=richard%40piedpiper.com" \
  -H "X-Tomba-Key: $TOMBA_API_KEY" \
  -H "X-Tomba-Secret: $TOMBA_SECRET_KEY"

const res = await fetch("https://api.tomba.io/v1/enrich?email=richard%40piedpiper.com", {
  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/enrich?email=richard%40piedpiper.com",
    headers={
        "X-Tomba-Key": os.environ["TOMBA_API_KEY"],
        "X-Tomba-Secret": os.environ["TOMBA_SECRET_KEY"],
    },
)
data = res.json()["data"]

// 02 · how it works

API Key to Production in Minutes

Three steps to integrate Tomba into any application, CRM, or automation workflow

01
Get your API key
Sign up free, grab your API key and secret from the dashboard. No credit card, no approval process.
02
Make your first call
Install our SDK (pip install tomba, npm install tomba, etc.) and make your first enrichment call in 3 lines of code.
03
Get enriched JSON back
Receive verified emails, phones, company data, and confidence scores in a clean JSON response.

// 03 · features

Everything Developers Need

Build on Tomba with confidence we handle the data infrastructure so you can focus on your product.

13 Official SDKs
C#, Dart, Deno, Elixir, Go, Lua, Node.js, Perl, PHP, Python, R, Ruby and Rust. Install with one command. All 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
Connect Tomba to Claude, Cursor, Windsurf, and other AI tools via the Model Context Protocol. Your AI assistant finds emails for you.
CLI Tool
Find and verify emails from your terminal. Pipe output to scripts, cron jobs, and CI/CD pipelines for automated enrichment.
Bulk & Async APIs
Submit thousands of lookups as a batch job. Get notified via webhook when processing completes. No polling needed.
Full Documentation
Comprehensive API reference, quickstart guides, code examples for every endpoint, and a Postman collection. Ship faster.
API Key + Secret Auth
Simple and secure authentication. Generous rate limits on all plans. No OAuth complexity.
15+ Endpoints
Email finder, verifier, domain search, company enrichment, phone finder, author finder, LinkedIn finder, similar domains, and more.
Works With Everything
REST API means it works with any language, any framework, any platform. Zapier and Make integrations also available.

// 04 · tools

The tools this team uses

Person Enrichment Company Enrichment CSV Enrichment MCP Server

I have tested over a dozen email finder tools, and Tomba.io stands out as the best. It provides a solid SDK and clear, well-documented guides, making integration fast and straightforward.
Andrei KholkinFounder, Superpage.io
The data is always fresh, and the n8n integration is excellent for my use case. Support is very responsive overall. I would rate it 9/10.
Benjie MalinaoCo-Founder & CTO, Channel Automation
Tomba.io is very fast and has lots of features. I use Apollo to find companies and then run those leads into Tomba.io to grab prospect info in record time.
Julian M.Account Executive, Insight
As a Founder and sales leader, there are three things important to me: cost effective, easy to use, and accurate data. I actively recommend Tomba.io.
Kevin DixonFounder, Boxxstep

// faq

API Questions

Still have questions? Visit the help center

const res = await fetch("https://api.tomba.io/v1/email-finder?domain=piedpiper.com&first_name=Richard&last_name=Hendricks", { 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?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"]

{ "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": [] } }

Enrich Contacts in Real-Time from Your Own Code

The calls behind this workflow

API Key to Production in Minutes

Get your API key

Make your first call

Get enriched JSON back

Everything Developers Need

13 Official SDKs

Limits You Can Plan For

MCP Server

CLI Tool

Bulk & Async APIs

Full Documentation

API Key + Secret Auth

15+ Endpoints

Works With Everything

The tools this team uses

API Questions

Make your first call in a minute