Match
Accepts company attributes and returns matching companies ranked by relevance. At least one of companyName, website, socialProfile, socialProfileId, or listing is required; the first four are plain strings, listing takes (ticker, exchange) pairs, and each is a hard requirement. On the attribute filters (industry, country, etc.) 'or' is a soft ranking preference while 'and' is a hard filter accepting a single value; 'not' values are hard exclusions.
Request body
Each filter is an object of and / or / not arrays. or boosts matches without excluding others; use and with a single value to filter.
- Company name. Supply this, website, socialProfile, or socialProfileId
- websitestringOptionalCompany website, normalized to strip protocol and query string. Supply this, companyName, socialProfile, or socialProfileId
- socialProfilestringOptionalSocial profile URL of the company, normalized to strip protocol, subdomain, and query string. Supply this, companyName, website, or socialProfileId
- socialProfileIdstringOptionalNumeric social profile ID of the company, matched exactly. Supply this, companyName, website, or socialProfile
- Filter by company type. 'or' boosts matches without excluding other types; use 'and' with a single value to filter
and accepts at most one value here — a company has exactly one; use or to match any of several.
ANDpublicThe single value the company must hold (hard filter). A company holds exactly one value, so more than one distinct value (compared after trimming and, except for the range codes, ignoring case) is rejected with a 400, as is a value that is also in not
ORValues that raise the ranking of companies holding any of them, without excluding the rest
NOTValues the company must not hold (hard exclusion)
Pick a suggestion or press Enter · Backspace on empty removes the last - Filter by industry. 'or' boosts matches without excluding others; use 'and' with a single value to filter
and accepts at most one value here — a company has exactly one; use or to match any of several.
ANDThe single value the company must hold (hard filter). A company holds exactly one value, so more than one distinct value (compared after trimming and, except for the range codes, ignoring case) is rejected with a 400, as is a value that is also in not
ORcomputer softwareValues that raise the ranking of companies holding any of them, without excluding the rest
NOTValues the company must not hold (hard exclusion)
Pick a suggestion or press Enter · Backspace on empty removes the last - countryobjectOptionalFilter by country. 'or' boosts matches without excluding others; use 'and' with a single value to filter
and accepts at most one value here — a company has exactly one; use or to match any of several.
ANDThe single value the company must hold (hard filter). A company holds exactly one value, so more than one distinct value (compared after trimming and, except for the range codes, ignoring case) is rejected with a 400, as is a value that is also in not
ORunited statesValues that raise the ranking of companies holding any of them, without excluding the rest
NOTValues the company must not hold (hard exclusion)
Enter adds a value · Backspace on empty removes the last - Filter by ISO 3166-1 alpha-2 country code, such as 'DE'. Matched case-insensitively; an unrecognized code is rejected with a 400. 'or' boosts matches without excluding others; use 'and' with a single value to filter
- regionobjectOptionalFilter by region (state/province). 'or' boosts matches without excluding others; use 'and' with a single value to filter
and accepts at most one value here — a company has exactly one; use or to match any of several.
ANDThe single value the company must hold (hard filter). A company holds exactly one value, so more than one distinct value (compared after trimming and, except for the range codes, ignoring case) is rejected with a 400, as is a value that is also in not
ORcaliforniaValues that raise the ranking of companies holding any of them, without excluding the rest
NOTValues the company must not hold (hard exclusion)
Enter adds a value · Backspace on empty removes the last - localityobjectOptionalFilter by locality (city). 'or' boosts matches without excluding others; use 'and' with a single value to filter
and accepts at most one value here — a company has exactly one; use or to match any of several.
ANDThe single value the company must hold (hard filter). A company holds exactly one value, so more than one distinct value (compared after trimming and, except for the range codes, ignoring case) is rejected with a 400, as is a value that is also in not
ORsan franciscoValues that raise the ranking of companies holding any of them, without excluding the rest
NOTValues the company must not hold (hard exclusion)
Enter adds a value · Backspace on empty removes the last - Filter by employee count range. 'or' boosts matches without excluding others; use 'and' with a single value to filter
and accepts at most one value here — a company has exactly one; use or to match any of several.
ANDThe single value the company must hold (hard filter). A company holds exactly one value, so more than one distinct value (compared after trimming and, except for the range codes, ignoring case) is rejected with a 400, as is a value that is also in not
OR10001+Values that raise the ranking of companies holding any of them, without excluding the rest
NOTValues the company must not hold (hard exclusion)
Pick a suggestion or press Enter · Backspace on empty removes the last - Filter by inferred revenue range. 'or' boosts matches without excluding others; use 'and' with a single value to filter
and accepts at most one value here — a company has exactly one; use or to match any of several.
ANDThe single value the company must hold (hard filter). A company holds exactly one value, so more than one distinct value (compared after trimming and, except for the range codes, ignoring case) is rejected with a 400, as is a value that is also in not
OR$10B+Values that raise the ranking of companies holding any of them, without excluding the rest
NOTValues the company must not hold (hard exclusion)
Pick a suggestion or press Enter · Backspace on empty removes the last - Filter by primary stock exchange, on its own. 'or' boosts matches without excluding others; use 'and' with a single value to filter. Reach for this to screen by exchange alone; when you know the ticker too, send them together as 'listing'
- Filter by primary ticker symbol, on its own. 'or' boosts matches without excluding others; use 'and' with a single value to filter. Reach for this when the exchange is unknown; when you know it, send the two together as 'listing'
- listingobjectOptionalStock listing as a (ticker, exchange) pair — a ticker is unique only within an exchange, so the pair is what identifies a listing. Each pair must carry both halves, and 'or' values are a hard requirement: the company must hold one of the pairs. Counts as an identity field, so a listing alone is enough to match on. Only a company's primary listing is indexed, so a secondary cross-listing will not match
- notobject[]OptionalValues that must NOT match (hard exclusion)
- orobject[]OptionalValues where at least ONE must match (hard requirement)
- Filter by latest funding stage. 'or' boosts matches without excluding others; use 'and' with a single value to filter
- Filter by funding round count (min/max)
- Filter by total funding amount (min/max)
- Filter by latest funding amount (min/max)
- Filter by latest funding date (gte/lte, supports YYYY, YYYY-MM, or YYYY-MM-DD)
- keywordsobjectOptionalKeyword filter matched against company description and tags. Unlike the other filters every clause here is hard and takes any number of values: 'and' requires all its keywords, 'or' requires at least one, 'not' excludes. Bounded by the total number of words across 'and', 'or' and 'not' rather than by the number of keywords, so one long phrase costs as much as several single words; a filter too large to evaluate is rejected with a 400
- Headers
x-api-keyRequired · API key for authentication
Response
- resultsobject[]
- displayNamestring
- aggkCompanyIdstringAggKnowledge company ID
- socialProfilestringNormalized company social profile URL. Absent when the company has none on file.
- socialProfileIdinteger (int64)Company social profile ID. Absent when the company has no social profile on file.
- namestring
- websitestring
- cleanedWebsitestringCompany website without its scheme, leading www., query string or trailing slash. Keeps any subdomain and path.
- cleanedDomainstringHost of the company website, without a leading www. or any path
- rootDomainstringRegistrable domain of the company website under the Public Suffix List, e.g. example.co.uk for shop.example.co.uk
- descriptionstringBrief description of the company
- tagsstring[]Tags associated with the company
- Type of company
- countrystringCountry of the company's primary address
- ISO 3166-1 alpha-2 code of the company's country
- primaryTickerstringPrimary stock ticker symbol, for public companies. Null when the company is not publicly traded.
- primaryExchangestringPrimary stock exchange the company trades on. Null when the company is not publicly traded.