// reveal
Describe your ideal customer, get the companies
Write the companies you want in plain words. Reveal lists the matches with their industry, size, city and how many addresses Tomba holds at each.
// api console
- companies
- 1 item
- companies[0].name
- Tomba
- companies[0].website_url
- tomba.io
- companies[0].industry
- Information Technology and Services
- companies[0].company_size
- 1-10
- companies[0].city
- Claymont
- companies[0].founded
- 2021
- companies[0].total_emails
- 28
// teams at these companies use tomba
// 01 · in the app
Reveal in the Tomba app
Describe the companies you want in the web app: the matches, their size and location, and how many addresses Tomba holds at each.
// 02 · the api
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.
/reveal/searchqueryrequired- What you are looking for, in plain language
page1- Result page
// cost
Rate limits by plan1search credit
Charged when: At least one company is returned.
Errors, 429 and 451 responses, and the same request again within your usage window cost nothing.
13 official SDKs: C#, Dart, Deno, Elixir, Go, Lua, Node.js, Perl, PHP, Python, R, Ruby, Rust. Libraries in the docs
{
"success": true,
"data": {
"companies": [
{
"name": "Pied Piper",
"description": "Middle-out compression for files and video.",
"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"
]
}
}
}
}/reveal/searchdata.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
// 03 · capabilities
From a sentence to a target list
Reveal reads what you ask for and returns companies you can act on.
Plain-language search
Ask for “B2B SaaS in France with 50 to 200 people” instead of building filters.
Industry, size and place
Each match shows its industry, headcount band, city and founding year.
The people at each company
See how many addresses Tomba holds at each company, then open them in Domain Search.
Similar companies
Start from a customer you like and find others like it.
Technology stack
See the tools a company runs, from its CMS to its analytics.
The same search in the API
POST the same sentence to /reveal/search and page through the matches.
// 04 · use cases
What teams build with Reveal
- Target account listsTurn your ideal customer profile into a list of companies in one search.
- New marketsSize a segment before you commit to it: who is there and how big they are.
- Agency pipelinesBuild a prospect list for each client's niche.
- Lookalike accountsFind more companies like your best customers.
// start free
Find the companies that fit your market
Describe the companies you want in a sentence. A search uses 1 search credit when at least one company comes back.
The free plan includes 25 search credits every 30 days.