Search companies
Authorizations
The access token received from the authorization server in the OAuth 2.0 flow.
Body
Opaque cursor token from a previous /search/companies response. Use this to fetch the next page of results.
"eyJwYWdlIjoyLCJzZWFyY2hJZCI6IjEyMzQ1In0="
Number of companies to return per page before credit-based trimming is applied. A larger value is reduced to 500 rather than rejected.
x <= 50050
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.
2
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.
1234
Company names to match. Use this when you know full company names or key name fragments.
100Matching strategy for companyName (default = standard matching, related = include aliases/related names, exact = exact company name only).
default, related, exact "related"
Company website domains to match (for example root domains without protocol).
100Company 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.
10Company 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.
10Company 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.
10Free-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.
10Widen 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.
25, 50, 100, 250 "50"
Industry categories to include in results. Valid values are the fixed industry list below.
5Accounting, 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 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. Up to 5 codes can be specified.
5Filter 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. Up to 5 codes can be specified. 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.
5Free-text keywords used to match company profile text (name, description, and related indexed company data).
10Controls how multiple 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).
false
Employee size bands to match against company headcount ranges.
100 - 1 (Self-employed), 2 - 10, 11 - 50, 51 - 200, 201 - 500, 501 - 1,000, 1,001 - 5,000, 5,001 - 10,000, 10,001+ Revenue range bands to match estimated company revenue.
10$0 - $100K, $100K - $1M, $1M - $5M, $5M - $20M, $20M - $50M, $50M - $100M, $100M - $500M, $500M - $1B, $1B+ Technologies used by the company. Sample enum values for documentation only (not exhaustive; actual values come from API/typeahead).
10Salesforce, HubSpot, Marketo, Outreach, Apollo If true, matches companies using any of the specified technologies (OR). If false, matches only companies using all specified technologies (AND).
true
Filter by company type. Public = companies with a known stock ticker/exchange, Private = all others.
Public, Private "Public"
Company age buckets based on founding date.
4Less than 1 Year, Last 1-3 Years, Last 4-10 Years, 10+ Years Filter companies by news/event classification type.
8Acquisition, Corporate Challenges, Cost Cutting, Expansion, Investment, Leadership, Partnership, Recognition Limit news/event results to a rolling day window (60, 90, 180, or 365 days). Only the first value is applied.
160, 90, 180, 365 Filter companies based on the date of their latest funding round (90, 180, 365 days or 3 years).
190, 180, 365, 1095 Filter companies based on the classifications of their latest funding round.
14Angel, Pre-Seed, Seed, Series A, Series B, Series C, Series D, Series E, Series F, Series G, Series H, Series I, Series J, Other Filter companies based on the total funding amount they have raised.
9$0 - $100K, $100K - $1M, $1M - $5M, $5M - $20M, $20M - $50M, $50M - $100M, $100M - $500M, $500M - $1B, $1B+ Response
Company Search Results
A list of companies
Pagination metadata for the current search result set.
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.