Welcome to Tomba Docs! Create a free Tomba account and gain instant access to 400+ million contacts!
Tomba

Reveal

Endpoint:https://api.tomba.io/v1

Company search and discovery operations


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.

Search CompaniesHeaders

  • X-Tomba-Keystring · required

    Tomba API Key X-Tomba-Key header. Format: YOUR_API_KEY

  • X-Tomba-Secretstring · required

    Tomba API Secret X-Tomba-Secret header. Format: YOUR_API_SECRET

Search Companies Request Body

  • querystring · minLength: 8 · maxLength: 100

    Natural language query - AI assistant will select appropriate filters for you

    Example: Real Estate in France
  • filtersobject

    Structured filters for company search

  • pageinteger · min: 1 · max: 1000

    Page number for pagination

    Default: 1
  • limitinteger · min: 1 · max: 100

    Number of results per page

    Default: 50

Search Companies Responses

Successful search response

  • successboolean · required

    Indicates if the request was successful

  • dataobject · required
  • messagestring

    Optional message