Reveal
Search companies by industry, size, location, and other filters
Search Companies
Searches Tomba's company database with structured filters or a natural-language query, and returns 50 companies per page.
When you send query, filters are generated from it with an AI model and any filters you send are ignored. The generated filters are returned in meta.filters; send them as filters to get the next pages without generating them again. Per-request webhooks aren't supported.
This endpoint has a fixed rate limit instead of your plan's limits; see Rate limits. See Credits and usage for when a request is charged.
Search Companies › Request Body
queryNatural-language description of the companies you want, 8 to 100 characters. Filters are generated from it on every request, so use it for the first request and send the returned meta.filters as filters for the next pages.
Structured filters for company search. Every filter is optional, and a company must match all the filters you send. Most values are matched against Tomba's company data, which isn't normalized to a fixed list; size, founded, and revenue accept only the values listed for them and ignore any other value.
pagePage number. Each page has up to 50 companies. On the Free plan outside a workspace, any page after the first returns page 1.
Search Companies › Responses
One page of matching companies.
successAlways true.
One page of companies, up to 50.
Paging, and the filters the search used.