Tomba

Reveal

Endpointhttps://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 Companies › Headers

X-Tomba-Key

string · required

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

X-Tomba-Secret

string · required

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

Search Companies › Request Body

query

string · minLength: 8 · maxLength: 100

Natural language query - AI assistant will select appropriate filters for you. Note: Use this only on the first request, then use the filters parameter for subsequent requests

Example: Real Estate in France

object

Structured filters for company search

page

integer · min: 1 · max: 1000

Page number for pagination

Default: 1

Search Companies › Responses

Successful search response

success

boolean · required

Indicates if the request was successful

object · required

object

message

string

Optional message

POST/reveal/search

curl --request POST \
  --url https://api.tomba.io/v1/reveal/search \
  --header 'Content-Type: application/json' \
  --header 'X-Tomba-Key: ta_xxxx' \
  --header 'X-Tomba-Secret: ts_xxxx' \
  --data '
{
  "query": "Real Estate Agency in france",
  "page": 1
}
'

shell

Example Request Body

{
  "query": "Real Estate Agency in france",
  "page": 1
}

json

Search using natural language - AI will generate filters automatically. The generated filters are returned in the meta.filters field of the response

application/json

Example Responses

{
  "success": true,
  "data": {
    "companies": [
      {
        "name": "TechCorp Inc",
        "description": "Leading software development company",
        "country": "US",
        "state": "California",
        "city": "San Francisco",
        "street_address": "123 Tech Street",
        "postal_code": "94105",
        "industry": "Technology",
        "company_size": "101-500",
        "type": "Private",
        "founded": "2015",
        "website_url": "https://techcorp.com",
        "total_emails": 150,
        "revenue": "$10M-$50M",
        "phone_number": true,
        "linkedin_url": "https://linkedin.com/company/techcorp",
        "facebook_url": "https://facebook.com/techcorp",
        "twitter_url": "https://twitter.com/techcorp",
        "total_similar": 25
      }
    ],
    "total": 1250,
    "page": 1,
    "limit": 50,
    "pages": 25
  },
  "meta": {
    "total": 1250,
    "page": 1,
    "limit": 50,
    "pages": 25,
    "filters": {
      "location_country": {
        "include": [
          "US"
        ],
        "exclude": []
      },
      "location_state": {
        "include": [
          "California"
        ],
        "exclude": []
      },
      "industry": {
        "include": [
          "Technology"
        ],
        "exclude": []
      },
      "size": {
        "include": [
          "101-500"
        ],
        "exclude": []
      }
    }
  }
}

json

application/json

Domain Suggestions Account

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 Companies › Headers

X-Tomba-Key

string · required

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

X-Tomba-Secret

string · required

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

Search Companies › Request Body

query

string · minLength: 8 · maxLength: 100

Natural language query - AI assistant will select appropriate filters for you. Note: Use this only on the first request, then use the filters parameter for subsequent requests

Example: Real Estate in France

object

Structured filters for company search

page

integer · min: 1 · max: 1000

Page number for pagination

Default: 1

Search Companies › Responses

Successful search response

success

boolean · required

Indicates if the request was successful

object · required

object

message

string

Optional message

curl --request POST \ --url https://api.tomba.io/v1/reveal/search \ --header 'Content-Type: application/json' \ --header 'X-Tomba-Key: ta_xxxx' \ --header 'X-Tomba-Secret: ts_xxxx' \ --data ' { "query": "Real Estate Agency in france", "page": 1 } '

{ "success": true, "data": { "companies": [ { "name": "TechCorp Inc", "description": "Leading software development company", "country": "US", "state": "California", "city": "San Francisco", "street_address": "123 Tech Street", "postal_code": "94105", "industry": "Technology", "company_size": "101-500", "type": "Private", "founded": "2015", "website_url": "https://techcorp.com", "total_emails": 150, "revenue": "$10M-$50M", "phone_number": true, "linkedin_url": "https://linkedin.com/company/techcorp", "facebook_url": "https://facebook.com/techcorp", "twitter_url": "https://twitter.com/techcorp", "total_similar": 25 } ], "total": 1250, "page": 1, "limit": 50, "pages": 25 }, "meta": { "total": 1250, "page": 1, "limit": 50, "pages": 25, "filters": { "location_country": { "include": [ "US" ], "exclude": [] }, "location_state": { "include": [ "California" ], "exclude": [] }, "industry": { "include": [ "Technology" ], "exclude": [] }, "size": { "include": [ "101-500" ], "exclude": [] } } } }