POST/companies/search

Search

Search for companies matching specific criteria. Supports filters for country, industry, employee count, revenue, keywords, technologies, company type, category, founded year, funding, and more. Also supports text search by name/domain and semantic natural language search. Max 10,000 results via page-based pagination. Use the scroll endpoint for larger result sets. Pagination billing: call the first page normally and save billing.requestId from the Orthogonal /v1/run response. For later page, offset, or cursor calls on the same logical search, pass parentRequestId with unchanged non-pagination parameters. Valid continuation calls still get their own request IDs and quoted price, but are charged 0. Changing filters starts a new billable request.

Company Enrich·Dynamic pricing

Dynamic pricing

body.pageSize * 0.01225

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: "company-enrich",
  path: "/companies/search",
  body: {
    "pageSize": "value"
  }
});

console.log(output);

Query parameters

expand

array

Expandable response fields. Repeat the parameter to request multiple expansions. Supported values: - `workforce`: costs 5 credits per company and adds the `workforce` field to `CompanyInfo`.

Body parameters

page

integer

The page number to return. Must be greater than 0 For later pages of the same logical search, keep non-pagination parameters unchanged and pass top-level parentRequestId from the first Orthogonal /v1/run response.

pageSizerequired

integer

REQUIRED. Number of results per page (1-100). Determines cost: 1 credit ($0.01225) per result returned. Total call cost = pageSize x per-result cost.

lists

array

The list IDs to filter by

semanticQuery

string

The semantic search query to find companies with. More natural language version of the standard query.

semanticWeight

number

The semantic weight to apply to the results. Must be between 0 and 1. 0.7 is default. Larger values will prioritize semantic similarity, smaller values will prioritize traditional search factors.

exclude

object

Exclusion filters to apply on the companies. If a company matches any of the filters here, it will be excluded from the results.

query

string

The search query to apply on the company name and domain

foundedYear

object

The range of years

fundingAmount

object

The funding amount range to filter by

fundingYear

object

The range of years

categoryOperator

string

The operator to apply to the filters. Defaults to And.

keywordsOperator

string

The operator to apply to the filters. Defaults to And.

technologiesOperator

string

The operator to apply to the filters. Defaults to And.

workforceGrowth

object

Filter companies by workforce growth percentage over a selected period and department.

workforceSize

array

Filter companies by absolute workforce headcount. Multiple entries can be provided to filter on different departments simultaneously.

require

array

The features that must exist for the company

regions

array

The region IDs to filter by

countries

array

The 2 letter country codes to filter by

states

array

The state IDs to filter by

cities

array

The city IDs to filter by

type

array

The list of company types to filter by