Skip to content
Tomba home
Start free

// ai company search

Find your ideal customers and reveal their contacts

B2B company search made simple. Filter 80M+ companies by industry, size, location, revenue, and keywords then reveal verified emails and direct phone numbers for decision-makers in one click. Trusted by 150,000+ professionals.

Get free API keyAPI reference

// api console

POSTapi.tomba.io/v1/reveal/search
Run it with a free API key
Example response from the API reference
CapterraCapterra
4.7/5
G2G2
4.7/5
Chrome Web StoreChrome Web Store
4.6/5

Based on verified reviews

// 01 · request

Reveal is one HTTPS request

Send the parameters with your key and secret. Every SDK, the CLI and the MCP server make this same call.

POST/reveal/searchParameter
queryrequired
What you are looking for, in plain language
page1
Result page

// official sdks

The same call from 13 official libraries, each one a thin wrapper over the REST API.

  • C#
  • Dart
  • Deno
  • Elixir
  • Go
  • Lua
  • Node.js
  • Perl
  • PHP
  • Python
  • R
  • Ruby
  • Rust
Libraries in the docs

// 02 · response

What comes back

JSON, the same in every language. Fields Tomba doesn't know are null, never guessed.

POST/reveal/searchField
data.companies[]array | null
Name, website, description, industry, size, type, founded, revenue, location, social links
data.companies[].total_emailsinteger
Addresses Tomba holds for the company
data.companies[].total_similarinteger
Similar companies Tomba knows
meta.total, meta.pagesinteger
Companies that match, and pages
meta.page, meta.limitinteger
This page and its size
meta.filtersobject
The filters Tomba read from your query
POST /reveal/search
200 OK· 1 search credit
{
  "success": true,
  "data": {
    "companies": [
      {
        "name": "Pied Piper",
        "description": "Pied Piper builds middle-out compression for files, video and a decentralized internet.",
        "country": "US",
        "state": "California",
        "city": "Palo Alto",
        "street_address": "5230 Newell Road",
        "postal_code": "94303",
        "industry": "computer software",
        "company_size": "11-50",
        "type": "privately held",
        "founded": "2014",
        "website_url": "piedpiper.com",
        "total_emails": 48,
        "revenue": "",
        "phone_number": false,
        "linkedin_url": "https://www.linkedin.com/company/pied-piper",
        "facebook_url": "",
        "twitter_url": "",
        "total_similar": 2
      }
    ]
  },
  "meta": {
    "total": 64,
    "page": 1,
    "limit": 10,
    "pages": 7,
    "filters": {
      "location_state": {
        "include": [
          "California"
        ]
      },
      "industry": {
        "include": [
          "computer software"
        ]
      }
    }
  }
}

// 03 · cost and limits

What a call costs

A call is charged only under the condition below. Rate limits depend on your plan.

// cost

1search credit

Charged when: Per request, when at least one company is returned.

Errors, 429 and 451 responses, and the same request again within your usage window cost nothing.

How credits work

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

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 · use it anywhere

Reveal beyond the API

The same endpoint, and the same credits, behind the app and every integration.

// 05 · capabilities

Company Reveal Features

Everything you need to know about any company from a single domain lookup. Accurate, verified, and always up to date.

  • Company Profile

    Instantly see company name, description, logo, founding year, and legal entity type so you qualify leads before the first outreach.

  • Industry & Revenue

    Identify the company's primary industry, SIC/NAICS codes, and estimated annual revenue range essential data for accurate lead scoring.

  • Employee Count

    See estimated headcount and growth trends to gauge company size and momentum so you prioritize fast-growing accounts.

  • Location & Address

    Get the full headquarters address, city, state, country, and timezone perfect for territory mapping and localized outreach.

  • Social Profiles

    Find official LinkedIn, Twitter/X, Facebook, YouTube, and other social profiles verified and linked automatically.

  • Technology Stack

    Discover the CMS, analytics, marketing tools, hosting, and frameworks a company uses so you tailor your pitch to their stack.

  • Similar Companies

    Find companies in the same industry, size, and region build targeted prospect lists and competitive maps in minutes.

  • Domain Age & Registrar

    Check when the domain was registered, who the registrar is, and when it expires reliable trust signals at a glance.

  • Email Pattern Detection

    Detect the email format a company uses (e.g., first.last@, first@) predict employee email addresses with proven accuracy.

  • Accept-All Detection

    Know instantly if the domain's mail server accepts all emails critical for protecting your deliverability and sender reputation.

  • MX Records & DNS

    View mail exchange records and DNS configuration to understand the company's email infrastructure before you send.

  • WHOIS Data

    Access domain registration details including registrant info, name servers, and registration dates all in one place.

// use cases

What teams build with Reveal

// customers

Teams that run Reveal every day

  • The company data from Reveal is incredibly detailed. We use it to qualify every inbound lead automatically.
    Steffen BurandtHead of Business Development
  • Stellar product and amazing support. The technology stack data alone saves us hours of research.
    Martin EbongueEntrepreneur, Genius Data Flow

// faq

Frequently Asked Questions

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. 1Create a free account25 searches a month. No card.
  2. 2Copy your key and secretFrom API keys in the dashboard.
  3. 3Call the APIPaste the request; the answer is JSON.
Get free API keyRead the docs
curl "https://api.tomba.io/v1/email-finder?domain=piedpiper.com&first_name=Richard&last_name=Hendricks" \
  -H "X-Tomba-Key: $TOMBA_API_KEY" \
  -H "X-Tomba-Secret: $TOMBA_SECRET_KEY"
Response
200 OK· 1 search credit
{
  "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": []
  }
}