Search companies by firmographics, tech stack or keywords

Inputs

• pageinteger, optional

  1-based page number; page * pageSize may not exceed 10,000 — past that use the scroll route

• typestring, optional

  private, public, nonprofit, educational, government

• listsstring, optional

  restrict to saved list ids (dashboard feature, plan-gated)

• querystring, optional

  free-text match on company name and domain, max 250 chars

• citiesstring, optional

  city ids from the free POST /geo/cities

• expandstring, optional

  `workforce` costs 5 EXTRA credits PER COMPANY returned — expensive on a search

• statesstring, optional

  state ids from the free POST /geo/states

• excludeobject, optional

  domains/companies to drop; the per-search exclude cap is plan-bound (500 Starter → 50,000 Scale)

• regionsstring, optional

  region ids from the free GET /geo/regions

• requirestring, optional

  features that MUST be present on the company record

• revenuestring, optional

  revenue buckets, e.g. over-1b

• categorystring, optional

  b2b, b2c, b2g, saas, marketplace, service-provider …

• keywordsstring, optional

  description keywords; resolve them first with the free /keywords/autocomplete

• pageSizeinteger, optional

  1-100, default 10. THIS IS THE PRICE — 1 credit per company returned

• countriesstring, optional

  ISO 3166-1 alpha-2 codes

• employeesstring, optional

  employee-count buckets, e.g. 1-10, 5K-10K, over-10K

• naicsCodestring, optional

  2-6 digit NAICS; a short code matches all its children

• foundedYearobject, optional

  range object, e.g. {min: 2015, max: 2022}

• fundingYearobject, optional

  range object

• technologiesstring, optional

  technology-stack names; resolve them first with the free /technologies/autocomplete

• fundingAmountobject, optional

  range object in USD

• fundingRoundsstring, optional

  seed, debt_financing, angel, venture, series_a, series_b, series_c, series_d, series_e, series_f, series_g, series_h, other; hyphen forms like series-a are rejected

• semanticQuerystring, optional

  natural-language description of the companies you want; costs 2 credits per company instead of 1

• workforceSizestring, optional

  absolute headcount ranges, finer-grained than the buckets

• semanticWeightnumber, optional

  0-1, default 0.7 — higher favours semantic similarity over the structured filters

• workforceGrowthobject, optional

  filter by headcount growth rate over a window

• categoryOperatorstring, optional

  and | or — how multiple `category` values combine

• keywordsOperatorstring, optional

  and | or

• reportedEmployeesstring, optional

  same buckets, but the externally reported figure

• technologiesOperatorstring, optional

  and | or