Company Match

Returns match results of companies based on input criteria. The access rights for partner account restrict the available returned match output. The HTTP request for Company Match begins with the URL structure:

http://partnerapi.zoominfo.com/partnerapi/company/match?

Input Parameters – Company Match

The table below shows input parameters that can be used in Company Match queries. Parameter descriptions are grouped as follows:

  • Group - The grouping for search field permissions
  • Field Name - The name of the input parameter
  • Required - Denotes whether or not a query request requires the field
  • Value - Valid values for this input parameter
  • Notes - Information related to the input parameter
  • Key - Denotes whether or not the key generation uses the field. The order in which the parameters appear in the table is the order in which you should use them in the key. Of course, for match requests there will be one set of parameter values in the key for each input record passed into the request. Use each set of parameter values in the same order as their respective input records.
Group
Field Name
Required
Value
Notes
Key
Request-level Default
pc
required

Partner code (name) assigned to you
no
key
required

String consisting of 5 parameters concatenated together, and then encrypted with MD5. Parameters are:
 1) first 2 characters of every match term in each input record
 2) your partner password
 3) today's day (not padded with zero)
 4) today's month (not padded with zero)
 5) today's year (4 digit)
no
numMatches
optional
A number from 1 to 10
Limits the match results returned to the given number of match results per input record
no
echoInput
optional
true or false
Default value is false. If set to false, only the uniqueId for each input record is displayed in the XML output. If set to true, the uniqueId and all other input parameters for each input record are displayed in the XML output
no
outputFieldOptions
optional
 Company Match Query has the following optional output fields:
  • companyPhone
  • companyFax
  • companyRevenueNumeric
  • companyRevenueRange
  • companyEmployeeRange
  • companyTopLevelIndustry
  • companyLogo
  • companyHastags
  • companyProductsAndServices
  • acquiredByCompany
  • orderHashtags
  • companyType
  • techAttributes 
To return one or more of these fields, specify the above output field name(s). To return multiple optional output fields, separate the values with a comma. For example, "outputFieldOptions=companyPhone,companyFax" will return companyPhone and companyFax in the XML output,
no
Input Record-level Default
uniqueInputId
optional

The unique string which will be used to identify a particular match request input record within a single match request
no
companyId
optional

Unique ZoomInfo identifier of the company to be matched by a particular input record
yes
name
optional

Name of the company to be matched by a particular input record
yes
domain
optional

The domain of the company to be matched by a particular input record.
NOTE: If you have an email address and you would like to use it to help find a company match, you should pass the full email address into the domain parameter, rather than stripping out the domain from the email address.  Leaving the full email address in-tact will allow the company matcher to properly use a meaningful domain while ignoring a “freemail” account domain (i.e. google.com, yahoo.com, etc…) in that email address.
yes
ticker
optional

The ticker of the company to be matched by a particular input record
yes
phone (up to 5)
optional

A phone number of the company to be matched by a particular input record. You can enter up to 5 sets of company contact information for each input record and each set of contact information can contain any combination of phone, fax, street, city, state, zip, and/or country. For GET requests these contact parameters must be named "phone1", "phone2",... "phone5"
no
fax (up to 5)
optional

A fax number of the company to be matched by a particular input record. You can enter up to 5 sets of company contact information for each input record and each set of contact information can contain any combination of phone, fax, street, city, state, zip, and/or country. For GET requests these contact parameters must be named "fax1", "fax2",... "fax5"
no
street (up to 5)
optional

A street of the company to be matched by a particular input record. You can enter up to 5 sets of company contact information for each input record and each set of contact information can contain any combination of phone, fax, street, city, state, zip, and/or country. For GET requests these contact parameters must be named "street1", "street2",... "street5"
no
city (up to 5)
optional

A city of the company to be matched by a particular input record. You can enter up to 5 sets of company contact information for each input record and each set of contact information can contain any combination of phone, fax, street, city, state, zip, and/or country. For GET requests these contact parameters must be named "city1", "city2",... "city5"
no
state (up to 5)
optional
See list of values.
Searches for people in one or more US states. Accepts multiple values by passing a comma-separated list (also accepts USA-all or Canada-all). Supports State abbreviations(MA,CA). It is case-insensitive. Blank values are not allowed.

no
zip (up to 5)
optional

A zip code of the company to be matched by a particular input record. You can enter up to 5 sets of company contact information for each input record and each set of contact information can contain any combination of phone, fax, street, city, state, zip, and/or country. For GET requests these contact parameters must be named "zip1", "zip2",... "zip5"
no
country (up to 5)
optional
See list of values.
Searches for people in one or more countries. Accepts multiple values by passing a comma-separated lis (Example: USA,Sweden,Brazil) It is case-insensitive. Blank values are not allowed. Both country code or names are accepted(Country.USA or USA). USA-all, Canada-all, uk-all, australia-all are also acceptable.


no


Example Company Match Request

The following example shows a request for a Company Match. The input parameters include:

  • 25248427 for companyId
  • The%20Mitre%20Corporation for Name

Note: We used %20 to denote where a space occurs in the name for the example .

The Company Match query should be structured like this:

http://partnerapi.zoominfo.com/partnerapi/company/match?pc=PartnerCode&companyId=25248427&Name=The%20Mitre%20Corporation&key=EncryptedKey

The Company Match XML output would appear as follows:

<companyMatchResponse xmlns="http://partnerapi.zoominfo.com/partnerapistatic/xsd/V1/CompanyMatchResponse.xsd">
<matchResults>
 <companyMatchResults>
 <companyMatchResult>
 <matchCompanyInput>
 <uniqueInputId>Zoom-1</uniqueInputId>
 </matchCompanyInput>
 <companyMatches>
 <companyMatch>
 <matchConfidence>100.0</matchConfidence>
 <companyId>25248427</companyId>
 <zoomCompanyUrl> http://www.zoominfo.com/#!search/profile/company?companyId=25248427&targetid=profile </zoomCompanyUrl>
 <companyDetailXmlUrl> http://partnerapi.zoominfo.com/partnerapi/company/detail?query_type=company_detail&CompanyID=25248427&pc=PartnerCode&key=da8967da9deffabb27e882d685016f8b </companyDetailXmlUrl>
 <companyName>The MITRE Corporation</companyName>
 <website>www.mitre.org</website>
 <companyAddress>
 <street>202 Burlington Road</street>
 <city>Bedford</city>
 <state>Massachusetts</state>
 <zip>01730</zip>
 <countryCode>United States</countryCode>
 </companyAddress>
 <companyDescription> About The MITRE Corporation: MITRE is a not-for-profit national technology resource that provides systems engineering, research and development, and information technology support to the government. It operates federally funded research and development centers for the Department of Defense, the Federal Aviation Administration and the Internal Revenue Service, with principal locations in Bedford, Massachusetts, and McLean, Virginia. MITRE was founded with the purpose of conducting scientific activities "to enhance the security of the United States of America or otherwise to further the public interest ..." </companyDescription>
 <industry>Sports Teams & Leagues</industry>
 <industry>Hospitality</industry>
 <industry>Software Development & Design</industry>
 <industry>Software</industry>
 </companyMatch>
 </companyMatches>
 </companyMatchResult>
 </companyMatchResults>
</matchResults>

Output Parameters – Company Match

The table below shows output parameters that can be used in Company Match queries. Parameter descriptions are grouped as follows:

  • Group - The grouping for output field permissions. The permission groups configured for a partner for company search queries determine the output fields present in a company match response.
  • Parent Name - The name of the output element
  • Child Name - The name of a child element of a parent element specified in the parent name column
  • Notes - Information related to the output field


Group
Parent Name
Child Name
Notes
Default
CompanyID

Unique identifier used by ZoomInfo for companies
ZoomCompanyUrl

The URL to the company profile on ZoomInfo.com public site
CompanyDetailXmlUrl

API request URL for Company Detail. Returned output will be in XML format
CompanyName

Full name of the company
CompanyTicker

The company's public stock exchange ticker
CompanyPhone

Phone number for the company. Optional: This output field is optional; it won't be shown unless the 'outputFieldOptions' parameter contains this output field
CompanyFax

Fax number for the company. Optional: This output field is optional; it won't be shown unless the 'outputFieldOptions' parameter contains this output field
Website

The web domain for the company in http://www.example.com format
CompanyLogo

The URL which can be used to retrieve the logo for the company.
CompanyAddress

Contains the following child elements describing the company's primary address
Street
Street address for the company's primary address
City
City for the company's primary address
State
State for the company's primary address
Zip
Zip code of the company's primary address
CountryCode
Country code of the company's primary address
CompanyDescription

A short paragraph describing the main purpose of the company
Hashtags
The list of hash tags for the displayed company. Each hash tag is composed of tag name and display label.
companyType
The type of the returned company. The value is one of the followings:public, private, npo, education, or government. (npo stands for non-profit organization) Optional:This outputfield won't be shown unless the 'outputFieldOptions' parameter contains “companyType”
Industries TopLevelIndustry
The top level (and therefore least specific) industrygrouping for the company. A company can have multiple top levelindustries. Optional: This output field won't be shown unless the 'outputFieldOptions' parameter contains“companyTopLevelIndustry”
Industry  The industry grouping for the company. A company can have multiple industries.
companySIC
Four-digit numerical codes assigned by the U.S. government to business establishments to identify the primary business of the establishment
companyNAICS
Define establishments based on the activities in which they are primarily engaged.
companyProductsAndServices
Products and services of the company

Revenue and Employees
Revenue

Approximate yearly revenue for the company
RevenueIn000s
Approximate numeric yearly revenue for the company in 1000's. Optional: This output field won't be shown unless the 'outputFieldOptions' parameter contains "companyRevenueNumeric"
RevenueRange
Approximate yearly revenue range for the company. Optional:This output field won't be shown unless the 'outputFieldOptions' parameter contains “companyRevenueRange”
Employees

Approximate number of people employed by the company
EmployeesRange

Approximate range for the number of people employed by the company. Optional:This output field won't be shown unless the 'outputFieldOptions' parameter contains “companyEmployeeRange”


Company Match – Tips

Unlike Company Search, the Company Match query finds companies that match as closely as possible to the matching criteria provided by you. Company Match has two major categories: Single-Input Matching and Multiple-Input Matching.

Single-Input Matching

Single-input matching uses only one match criteria in the request, and you get zero or one matches in the response.

Parameter
Matches
Notes
name
0 or 1

domain
0 or 1

companyId
0 or 1

ticker
0

phone
0

fax
0

address
0
includes street, city, state, country, and zip


Multiple-Input Matching

With multiple-input matching, you use more than one match criteria in the request and you get 0-10 matches in the response. Multiple input matching allows for more than one company match query parameter to be specified in the request. Minimally, either the name parameter or the domain parameter is required, otherwise the Company Match request will not return a match.

The Company Match query finds companies that match as closely as possible to the matching criteria.

Parameter
Matches
Name + any combination of other supported company match query parameters
0 or more
Any combination of supported company match query parameters (no name parameter)
0


Hint: Provide More Matching Criteria

The more matching criteria the better. The more criteria you specify in the request, the more accurate the match result will be.

Hint: Specify a Company Name

Specify a company name (if at all possible). It does not have to be the complete company name and may be an alternative name. Matching of company names is flexible but needs something to work with.

Was this article helpful?

Can’t find what you’re looking for?

Contact our award-winning customer care team.