Search Companies
POST
https://api.tomba.io/v1
/reveal/search
Search for companies using natural language queries or structured filters. The AI assistant will automatically generate appropriate filters from your query.
Headers
X-Tomba-Key
string · requiredTomba API Key X-Tomba-Key header. Format:
YOUR_API_KEY
X-Tomba-Secret
string · requiredTomba API Secret X-Tomba-Secret header. Format:
YOUR_API_SECRET
Request Body
query
string · minLength: 8 · maxLength: 100Natural language query - AI assistant will select appropriate filters for you
Example: Real Estate in Francefilters
objectStructured filters for company search
page
integer · min: 1 · max: 1000Page number for pagination
Default: 1limit
integer · min: 1 · max: 100Number of results per page
Default: 50
Responses
Successful search response
success
boolean · requiredIndicates if the request was successful
data
object · required
message
stringOptional message