API Documentation

Person API

Fetch social details tied to an email address name, location, gender, employment, Twitter, LinkedIn, GitHub, Gravatar, and verification status. A drop-in Clearbit Person API replacement.

Get API Key View Full Docs

Person API

LIVE

Company domain

Real API data no signup required

cURL

curl --request GET \
  --url 'https://api.tomba.io/v1/people/find?email=john.doe@stripe.com' \
  --header 'X-Tomba-Key: ta_xxxxxxxxxxxx' \
  --header 'X-Tomba-Secret: ts_xxxxxxxxxxxx'

200400429

{
  "data": {
    "name": {
      "fullName": "Mohamed Ben rebia",
      "givenName": "Mohamed",
      "familyName": "Ben rebia"
    },
    "email": "b.mohamed@tomba.io",
    "location": "DZ",
    "gender": "male",
    "geo": {
      "country": "Algeria",
      "countryCode": "DZ"
    },
    "employment": {
      "domain": "tomba.io",
      "name": "Tomba technology web service LLC",
      "title": "CEO",
      "role": "executive"
    },
    "linkedin": {
      "handle": "https://linkedin.com/in/mohamedbenrebia"
    },
    "twitter": {
      "handle": null
    },
    "github": {
      "handle": null
    },
    "gravatar": {
      "handle": null
    },
    "verification": {
      "date": "2026-03-25T00:00:00+01:00",
      "status": "valid"
    },
    "phone": true,
    "indexedAt": "2026-03-25T12:04:21+01:00"
  },
  "meta": {
    "email": "b.mohamed@tomba.io"
  }
}

Based on verified reviews

The Most Reliable Person API API

Tomba has the largest B2B email crawler on the web. We process billions of pages monthly so you always get the freshest, most accurate data.

2B+

Pages crawled monthly

450M+

Verified B2B emails

80M+

Domains indexed

Ranked in benchmark

81%

Email coverage

<5%

Bounce rate

<200ms

API response

99.9%

Uptime SLA

42M+

Tech-indexed sites

150K+

Professionals

Independent 5,000-Lead Benchmark

Same input file, same conditions, every provider. Raw results, no spin.

View raw data Data updates Robots policy

Tomba.io

4,015

Anymailfinder

3,875

Findymail

3,757

GetProspect

3,096

Skrapp

2,142

Hunter

1,882

VoilaNorbert

1,800

Snov

1,007

Prospeo

846

More Data, Less Money No One Comes Close

Every plan includes free verification credits, phone data, and credits valid for 12 months.

Basic

$49 /mo

5,000 total credits

2,500 finder + 2,500 Free Verification

Integrate Person API in Your Language

Install Tomba in your language. 10 official SDKs, all open-source on GitHub.

composer require tomba-io/php

Ruby

gem install tomba

go get github.com/tomba-io/go

luarocks install tomba

install.packages("tomba")

Elixir

{:tomba, "~> 1.0"}

Full API documentation View on GitHub MCP Server

Person API API Features

Full Name

First name, last name, and full name parsed from the email address.

Location & Geo

Country, city, state, country code, latitude, and longitude when available.

Employment Data

Current company domain, company name, job title, role, and seniority level.

LinkedIn Profile

LinkedIn profile URL linked to the email address.

Twitter / X Profile

Twitter handle, bio, followers, following, and location.

GitHub Profile

GitHub handle, avatar, company, blog, followers, and following count.

Gravatar

Gravatar handle, avatar URL, and associated profile URLs.

Email Verification

Real-time verification status (valid, invalid, catch-all) with verification date.

Phone Available

Indicates whether a phone number is available for the contact.

Gender Detection

Gender prediction based on the first name.

Activity Timestamps

Indexed date, last active date, and inactive date for data freshness.

Clearbit Replacement

Drop-in replacement for the Clearbit Person API with compatible data structure.

Trusted Worldwide

Everyone is switching to Tomba.io

Join thousands of companies worldwide who trust Tomba for their email finding needs

Trusted by Developers Worldwide

Tomba.io is very fast with lots of features. I run leads from Apollo into Tomba and grab prospect info in record time. I'm saving at least 5 hours a week. No joke.

Julian M.

Account Executive, Insight

I've tested over a dozen email finder tools, and Tomba.io stands out as the best. It consistently delivers accurate results. The SDK and docs make integration fast.

Andrei Kholkin

Founder, Superpage.io

Stellar product and amazing support. I have tested many tools and this one is far superior by far. I highly recommend it.

Martin Ebongué

Entrepreneur, Genius Data Flow

Since years, Tomba has provided the most results per search, and it keeps getting better. It recently became one of the most feature-rich tools for our list building.