POST/v2/live/company/match

Match

Accepts company attributes as and/or/not filters and returns matching companies ranked by relevance. name, website, socialProfile, socialProfileId, and listing take only 'or' and 'not'; their 'or' values are required matches. On keyword fields (industry, country, etc.) 'or' is a soft ranking preference while 'and' is a hard filter accepting a single value; 'not' values are hard exclusions.

Version: v2Open on v3
Rate limit: Tier 3 · 10–200 rps by plan
Billing: Company Search · Match

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.

companyTypeobjectOptional
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.
AND
public
The 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
Values that raise the ranking of companies holding any of them, without excluding the rest
NOT
Values the company must not hold (hard exclusion)
Pick a suggestion or press Enter · Backspace on empty removes the last
countryobjectOptional
Filter 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.
AND
The 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
united states
Values that raise the ranking of companies holding any of them, without excluding the rest
NOT
Values the company must not hold (hard exclusion)
Enter adds a value · Backspace on empty removes the last
countryCodeobjectOptional
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
employeeCountRangeobjectOptional
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.
AND
The 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
10001+
Values that raise the ranking of companies holding any of them, without excluding the rest
NOT
Values the company must not hold (hard exclusion)
Pick a suggestion or press Enter · Backspace on empty removes the last
fundingRoundCountobjectOptional
Filter by funding round count (min/max)
fundingTotalobjectOptional
Filter by total funding amount (min/max)
industryobjectOptional
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.
AND
The 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
computer software
Values that raise the ranking of companies holding any of them, without excluding the rest
NOT
Values the company must not hold (hard exclusion)
Pick a suggestion or press Enter · Backspace on empty removes the last
latestFundingAmountobjectOptional
Filter by latest funding amount (min/max)
latestFundingDateobjectOptional
Filter by latest funding date (gte/lte, supports YYYY, YYYY-MM, or YYYY-MM-DD)
latestFundingStageobjectOptional
Filter by latest funding stage. 'or' boosts matches without excluding others; use 'and' with a single value to filter
listingobjectOptional
Filter by stock 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. Only a company's primary listing is indexed, so a secondary cross-listing will not match
- notobject[]Optional
  Values that must NOT match (hard exclusion)
- orobject[]Optional
  Values where at least ONE must match (hard requirement)
{ "or": [ { "ticker": "CRM", "exchange": "xnys" } ] }
localityobjectOptional
Filter 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.
AND
The 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
san francisco
Values that raise the ranking of companies holding any of them, without excluding the rest
NOT
Values the company must not hold (hard exclusion)
Enter adds a value · Backspace on empty removes the last
nameobjectOptional
Filter by company name (searches name, display name, and alternative names). Use 'or' for several candidate names
OR
salesforce
Values where at least ONE must match (hard requirement)
NOT
Values that must NOT match (hard exclusion)
Enter adds a value · Backspace on empty removes the last
primaryExchangeobjectOptional
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'
primaryTickerobjectOptional
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'
regionobjectOptional
Filter 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.
AND
The 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
california
Values that raise the ranking of companies holding any of them, without excluding the rest
NOT
Values the company must not hold (hard exclusion)
Enter adds a value · Backspace on empty removes the last
revenueRangeInferredobjectOptional
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.
AND
The 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
NOT
Values the company must not hold (hard exclusion)
Pick a suggestion or press Enter · Backspace on empty removes the last
socialProfileobjectOptional
Filter by social profile URL (searches LinkedIn URL and social profile fields; input is normalized to strip protocol, subdomain, and query string while preserving path). Use 'or' for several candidate profiles
OR
linkedin.com/company/salesforce
Values where at least ONE must match (hard requirement)
NOT
Values that must NOT match (hard exclusion)
Enter adds a value · Backspace on empty removes the last
socialProfileIdobjectOptional
Filter by social profile ID (the numeric LinkedIn company ID). Matched exactly, so 'or' values are a hard requirement
websiteobjectOptional
Filter by website (searches website and domain fields; input is normalized to strip protocol and query string). Use 'or' for several candidate websites
OR
salesforce.com
Values where at least ONE must match (hard requirement)
NOT
Values that must NOT match (hard exclusion)
Enter adds a value · Backspace on empty removes the last
keywordsobjectOptional
Keyword filter matched against company description and tags. 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-key Required · API key for authentication

Request

{
  "name": {
    "or": [
      "salesforce"
    ]
  },
  "website": {
    "or": [
      "salesforce.com"
    ]
  },
  "socialProfile": {
    "or": [
      "linkedin.com/company/salesforce"
    ]
  },
  "companyType": {
    "and": [
      "public"
    ]
  },
  "industry": {
    "or": [
      "computer software"
    ]
  },
  "country": {
    "or": [
      "united states"
    ]
  },
  "region": {
    "or": [
      "california"
    ]
  },
  "locality": {
    "or": [
      "san francisco"
    ]
  },
  "employeeCountRange": {
    "or": [
      "10001+"
    ]
  },
  "revenueRangeInferred": {
    "or": [
      "$10B+"
    ]
  },
  "listing": {
    "or": [
      {
        "ticker": "CRM",
        "exchange": "xnys"
      }
    ]
  }
}

11 of 21 parameters set. Edit values inline or add more from the list.

Response

resultsobject[]
- displayNamestring
- idinteger (int64)
- linkedinUrlstring
- linkedinIdinteger (int64)
  Company LinkedIn ID
- namestring
- websitestring
- descriptionstring
  Brief description of the company
- tagsstring[]
  Tags associated with the company
- companyTypeenum CompanyType
  Type of company
- countrystring
  Country of the company's primary address
- countryCodeenum CountryCode
  ISO 3166-1 alpha-2 code of the company's country
- primaryTickerstring
  Primary stock ticker symbol, for public companies. Null when the company is not publicly traded.
- primaryExchangestring
  Primary stock exchange the company trades on. Null when the company is not publicly traded.

Status codes

Response

Example

{
  "results": [
    {
      "displayName": "Salesforce",
      "id": 44002816,
      "linkedinUrl": "linkedin.com/company/salesforce",
      "linkedinId": 1815,
      "name": "salesforce",
      "website": "salesforce.com",
      "companyType": "public",
      "country": "united states",
      "primaryTicker": "CRM",
      "primaryExchange": "xnys"
    }
  ]
}