POST/v1/reveal/search

Search Companies

Search for companies using natural language queries or structured filters. AI assistant generates appropriate filters from your query.

Tomba·$0.01 per call

Example code

// Using @orth/sdk - The simplest way to call APIs
// Install: npm install @orth/sdk
import Orthogonal from "@orth/sdk";

const orthogonal = new Orthogonal({
  apiKey: process.env.ORTHOGONAL_API_KEY,
});

const output = await orthogonal.run({
  api: "tomba",
  path: "/v1/reveal/search"
});

console.log(output);

Body parameters

query

string

Natural language query (8-100 chars). AI generates filters from this. Use only on first request, then use filters for pagination.

filters

object

Structured filters: company, location_country, location_city, location_state, industry, size, type, keywords, founded, technologies, similar, revenue, sic, naics. Each has include/exclude arrays.

page

integer

Page number for pagination (1-1000, default: 1)

Response

data.companies

array

meta.page

number

meta.limit

number

meta.pages

number

meta.total

number

meta.filters.size.exclude

array

meta.filters.size.include.0

string

meta.filters.keywords.exclude

array

meta.filters.keywords.include.0

string

meta.filters.location_city.exclude

array

meta.filters.location_city.include.0

string

meta.filters.location_country.exclude

array

meta.filters.location_country.include.0

string

success

boolean