Skip to main content
POST
Search companies

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Scopes

publicAPI.v1.all

Public API v1

Body

application/json
nextToken
string

Opaque cursor token from a previous /search/companies response. Use this to fetch the next page of results.

Example:

"eyJwYWdlIjoyLCJzZWFyY2hJZCI6IjEyMzQ1In0="

limit
integer
default:50

Number of companies to return per page before credit-based trimming is applied. A larger value is reduced to 500 rather than rejected.

Required range: x <= 500
Example:

50

page
integer
default:1

Page number for offset-based pagination, starting at 1. nextToken is the preferred way to page through results and takes precedence when both are sent.

Example:

2

savedSearchId
integer

Run the filters held by a saved search instead of sending them. Get the id from GET /saved-searches. The saved search must be a company search. Cannot be combined with any other filter; doing so returns a validation error. limit, page and nextToken are still accepted.

Example:

1234

companyName
string[]

Company names to match. Use this when you know full company names or key name fragments.

Example:
companyNameSearchType
enum<string>
default:default

Matching strategy for companyName (default = standard matching, related = include aliases/related names, exact = exact company name only).

Available options:
default,
related,
exact
Example:

"related"

companyDomain
string[]

Company website domains to match (for example root domains without protocol).

Example:
companyState
string[]

Company location state filters. Accepts a US state name or abbreviation and non-US subdivisions alike ("CA", "California", "Ontario"). A company matches if it is in any of these states, narrowed by companyCountry when that is supplied too. Prefix a value with - to exclude it; an excluded state stands alone, since exclusions narrow on their own. Values match a fixed vocabulary of place names spelled the way our data spells them, which is usually the English exonym — Germany's state is "Bavaria", not "Bayern". US state names and abbreviations are both resolved, so neither needs a lookup. Use GET /search/locations to find the spelling for anything else; a value the vocabulary does not hold matches no companies and comes back under warnings, with suggestions, rather than as an error.

Maximum array length: 10
Example:
companyCountry
string[]

Company location country filters. Narrows companyState rather than widening it, so companyState: ["Virginia"] with companyCountry: ["United States"] returns Virginia companies only. A state and country that do not belong together narrow to nothing: companyState: ["Texas"] with companyCountry: ["Germany"] matches no companies, since no company is in both — that pair comes back under warnings too, suggesting the state's real country. Use locations when you mean either place rather than both. It does not narrow locations — put the country inside the tag itself ("Austin, Texas, United States") to scope a free-form value. Prefix a value with - to exclude it; an excluded country stands alone and narrows nothing. "US", "USA" and "United States of America" all resolve to the United States. Use GET /search/locations?types=country to find any other country's spelling; a value the vocabulary does not hold matches no companies and comes back under warnings, with suggestions, rather than as an error.

Maximum array length: 10
Example:
companyZipCode
string[]

Company postal/zip code filters. Widens the other location filters rather than narrowing them: a company matches if it is in any of these zip codes, or in anything locations / companyState ask for. Send it as the only location filter to match zip codes alone. Prefix a value with - to exclude it.

Maximum array length: 10
Example:
locations
string[]

Free-form location filter — city, state/region, or country — and the only filter that reaches city-level matching. Values may be a single place ("Austin") or comma-separated to disambiguate ("Austin, Texas", "Ontario, Canada"). Prefix a value with - to exclude it. A company matches if it is in any of these places, or in any companyState. Cities are the largest part of the vocabulary and the part no list can enumerate — use GET /search/locations to find one, and pass the returned location string verbatim. Its count is what separates a name meaning several places: "Ontario" is a Canadian province and a larger California city.

Maximum array length: 10
Example:
locationRadius
enum<string> | null

Widen the company location filters to everything within a radius of each value. Applies to locations, companyState, and companyZipCode alike — there is a single radius for every company location filter. The value is the radius in miles, sent as a string or a number. Only geocodable values get a radius — a city or zip code resolves to coordinates, a country does not. This is the form GET /saved-searches reads a radius back in, so those values can be sent straight through here. The spelled-out label (25 miles) is accepted too, as are the options 1, 2, 3, and 4 this filter originally took, which mean 25, 50, 100, and 250 miles respectively.

Available options:
25,
50,
100,
250
Example:

"50"

industry
enum<string>[]

Industry categories to include in results. Valid values are the fixed industry list below.

Available options:
Accounting,
Airlines/Aviation,
Alternative Dispute Resolution,
Alternative Medicine,
Animation,
Apparel & Fashion,
Architecture & Planning,
Arts and Crafts,
Automotive,
Aviation & Aerospace,
Banking,
Biotechnology,
Broadcast Media,
Building Materials,
Business Supplies and Equipment,
Capital Markets,
Chemicals,
Civic & Social Organization,
Civil Engineering,
Commercial Real Estate,
Computer & Network Security,
Computer Games,
Computer Hardware,
Computer Networking,
Computer Software,
Construction,
Consumer Electronics,
Consumer Goods,
Consumer Services,
Cosmetics,
Dairy,
Defense & Space,
Design,
E-Learning,
Education Management,
Electrical/Electronic Manufacturing,
Entertainment,
Environmental Services,
Events Services,
Executive Office,
Facilities Services,
Farming,
Financial Services,
Fine Art,
Fishery,
Food & Beverages,
Food Production,
Fund-Raising,
Furniture,
Gambling & Casinos,
Glass, Ceramics & Concrete,
Government Administration,
Government Relations,
Graphic Design,
Health, Wellness and Fitness,
Higher Education,
Hospital & Health Care,
Hospitality,
Human Resources,
Import and Export,
Individual & Family Services,
Industrial Automation,
Information Services,
Information Technology and Services,
Insurance,
International Affairs,
International Trade and Development,
Internet,
Investment Banking,
Investment Management,
Judiciary,
Law Enforcement,
Law Practice,
Legal Services,
Legislative Office,
Leisure, Travel & Tourism,
Libraries,
Logistics and Supply Chain,
Luxury Goods & Jewelry,
Machinery,
Management Consulting,
Maritime,
Market Research,
Marketing and Advertising,
Mechanical or Industrial Engineering,
Media Production,
Medical Devices,
Medical Practice,
Mental Health Care,
Military,
Mining & Metals,
Motion Pictures and Film,
Museums and Institutions,
Music,
Nanotechnology,
Newspapers,
Non-Profit Organization Management,
Oil & Energy,
Online Media,
Outsourcing/Offshoring,
Package/Freight Delivery,
Packaging and Containers,
Paper & Forest Products,
Performing Arts,
Pharmaceuticals,
Philanthropy,
Photography,
Plastics,
Political Organization,
Primary/Secondary Education,
Printing,
Professional Training & Coaching,
Program Development,
Public Policy,
Public Relations and Communications,
Public Safety,
Publishing,
Railroad Manufacture,
Ranching,
Real Estate,
Recreational Facilities and Services,
Religious Institutions,
Renewables & Environment,
Research,
Restaurants,
Retail,
Security and Investigations,
Semiconductors,
Shipbuilding,
Sporting Goods,
Sports,
Staffing and Recruiting,
Supermarkets,
Telecommunications,
Textiles,
Think Tanks,
Tobacco,
Translation and Localization,
Transportation/Trucking/Railroad,
Utilities,
Venture Capital & Private Equity,
Veterinary,
Warehousing,
Wholesale,
Wine and Spirits,
Wireless,
Writing and Editing
Example:
industrySicCodes
string[]

Filter by SIC code. Applied independently of industry, so the two can be combined or used on their own. Prefix a value with - to exclude it.

Maximum array length: 5
Example:
industryNaicsCodes
string[]

Filter by NAICS code. Applied independently of industry, so the two can be combined or used on their own. Prefix a value with - to exclude it. On API v2, unrecognized codes are rejected with a validation error. Matching is against the company's own naicsCode. A company that has no naicsCode of its own also matches when its SIC code maps to a requested code.

Maximum array length: 5
Example:
companyKeyword
string[]

Free-text keywords used to match company profile text (name, description, and related indexed company data). Prefix a value with - to exclude it. Excluded keywords always narrow the results (AND logic) regardless of keywordsIsOr, so ["fintech", "payments", "-agency"] with keywordsIsOr: true means (fintech OR payments) AND NOT agency.

Example:
keywordsIsOr
boolean
default:false

Controls how multiple positive companyKeyword values are combined. When false (default), a company must match all of the keywords (AND logic). When true, matching any one of them is enough (OR logic). Keywords prefixed with - are always excluded, whichever mode is used.

Example:

false

companySize
enum<string>[]

Employee size bands to match against company headcount ranges.

Maximum array length: 10
Available options:
0 - 1 (Self-employed),
2 - 10,
11 - 50,
51 - 200,
201 - 500,
501 - 1,000,
1,001 - 5,000,
5,001 - 10,000,
10,001+
Example:
companyRevenue
enum<string>[]

Revenue range bands to match estimated company revenue.

Maximum array length: 10
Available options:
$0 - $100K,
$100K - $1M,
$1M - $5M,
$5M - $20M,
$20M - $50M,
$50M - $100M,
$100M - $500M,
$500M - $1B,
$1B+
Example:
technologies
string[]

Technologies used by the company. Accepts any technology name, such as Salesforce, HubSpot, or Marketo.

Example:
technologiesIsOr
boolean
default:true

If true, matches companies using any of the specified technologies (OR). If false, matches only companies using all specified technologies (AND).

Example:

true

companyType
enum<string> | null

Filter by company type. Public = companies with a known stock ticker/exchange, Private = all others.

Available options:
Public,
Private
Example:

"Public"

foundedOn
enum<string>[]

Company age buckets based on founding date.

Maximum array length: 4
Available options:
Less than 1 Year,
Last 1-3 Years,
Last 4-10 Years,
10+ Years
Example:
newsTypes
enum<string>[]

Filter companies by news/event classification type.

Maximum array length: 8
Available options:
Acquisition,
Corporate Challenges,
Cost Cutting,
Expansion,
Investment,
Leadership,
Partnership,
Recognition
Example:
newsTypeDates
enum<string>[]

Limit news/event results to a rolling day window (60, 90, 180, or 365 days). Sending more than one value returns a validation error.

Maximum array length: 1
Available options:
60,
90,
180,
365
Example:
latestFundingDates
enum<string>[]

Filter companies based on the date of their latest funding round (90, 180, 365 days or 3 years).

Maximum array length: 1
Available options:
90,
180,
365,
1095
Example:
latestFundingClassifications
enum<string>[]

Filter companies based on the classifications of their latest funding round.

Maximum array length: 14
Available options:
Angel,
Pre-Seed,
Seed,
Series A,
Series B,
Series C,
Series D,
Series E,
Series F,
Series G,
Series H,
Series I,
Series J,
Other
Example:
latestFundingTotals
enum<string>[]

Filter companies based on the total funding amount they have raised.

Maximum array length: 9
Available options:
$0 - $100K,
$100K - $1M,
$1M - $5M,
$5M - $20M,
$20M - $50M,
$50M - $100M,
$100M - $500M,
$500M - $1B,
$1B+
Example:

Response

Company Search Results

success
boolean
Example:

true

data
object[]

A list of companies

supplementalData
object

Pagination metadata for the current search result set.

warnings
object[]

Non-fatal notices about the request, absent when there are none. The search ran regardless. Today this reports location filter values that name nowhere in the search index, which is the difference between a typo and an empty result set. A companyState and companyCountry that cannot both be true — ["Texas"] with ["Germany"] — is reported the same way, on the field companyState+companyCountry, since the pair is what company search matches on and neither half is wrong by itself. It is reported only when no combination of the two survives: the pairing is a cross product, so ["Texas", "Bavaria"] with ["United States", "Germany"] is a working search whose two dead combinations match nothing and take nothing away. Values are reported rather than rejected so that a filter which has always been accepted keeps working; a warned value matches no contacts, so treat it as a request to fix, not as a result. Use GET /search/locations to find the spelling the index holds, or read suggestions below.