Company Search

The company search query provides access to full searching capability on company data. The result of the query shows a list of companies and information corresponding to the input criteria. Access rights for partner accounts are determined by your Service Level Agreement (SLA). The HTTP request for Company Search begins with the URL structure:

https://partnerapi.zoominfo.com/partnerapi/v4/company/search?

Input Parameters – Company Search

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

  • Group - The grouping for search field permissions
  • Field Name - 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



Group
Field Name
Required
Value
Notes
Default
pc
required

Partner code (name) assigned to you
outputType
optional
xml or json
The format type of the response output. Case insensitive.
key
required

OAuth access token returned from the OAuth token request:   https://partnerapi.zoominfo.com/partnerapi/v4/token
outputFieldOptions
optional

Company Search Query has the following optional output fields:
  • companyPhone
  • companyFax
  • companyRevenueNumeric
  • companyRevenueRange
  • companyEmployeeRange
  • companyTopLevelIndustry
  • companyLogo
  • companyHashtags
  • 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
Results Per Page
rpp
optional

Limits the results returned to the given number of results per page
page
optional

Provides the results for the given page, used in conjunction with rpp
Sort
SortBy
optional
See list of values.
Designates which field is used to sort the results. SortBy is required if SortOrder is specified. When the SortBy is not specified and the IndustryClassification is specified, the returned records are sorted by IndustryClassification in decreasing industry relevance.
SortOrder
optional
asc or desc
Default value is desc. SortBy is required if SortOrder is specified.
Company Name
companyName
optional

The name of the company being searched for. Will also accept a stock ticker or website domain as input.
Industry / Keyword
companyDesc
optional

Search for people whose companies match the given description.
IndustryClassification
optional
See list of values.
A hierarchy of industries. See list of industry codes here. Accepts multiple values by passing a comma-separated list.
IndustryKeywords
optional

Search for companies in the industry related to the given search term. Accepts multiple values by passing a comma-separated list.
IndustryCodeoptionalSIC####
NAICS#### 

(#### is a SIC or NAICS code)
Search for companies classified as a given search code value. Each code represents an industry area.
companyTypeoptionalpublic,
private,
education,
nonprofit,
 government
Search for companies that fall under given company sector category.Accepts multiple values by passing a comma-separated list. It is case-insensitive.
Company Size
RevenueClassificationMin
optional
See list of values.
Minimum revenue dollar amount of a company. Use this parameter with RevenueClassificationMax to set a range.
RevenueClassificationMax
optional
See list of values.
Maximum revenue dollar amount of a company. Use this parameter with RevenueClassificationMin to set a range.
EmployeeSizeClassificationMin
optional
See list of values.
Minimum employee size of a company. Use this parameter with EmployeeSizeClassificationMax to set a range.
EmployeeSizeClassificationMax
optional
See list of values.
Maximum employee size of a company. Use this parameter with EmployeeSizeClassificationMin to set a range.
CompanyRanking
optional
See list of values.
Restricts searches to a specific company ranked list Ex. Fortune 500. Accepts multiple values by passing a comma-separated list.
Geography
State
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.

MetroRegion
optional
See list of values.
Restricts searches to one or more metro regions. Accepts multiple values by passing a comma-separated list.
Country
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.

ZipCode
optional

Restricts search to an area determined by zip code. Use this parameter in combination with RadiusMiles to increase the size of the area to search.
RadiusMiles
optional
See list of values.
Used in conjunction with ZipCode, designates how far in miles from zip code to include in search.
location
optional

Accepts any address, city, state, country, or zipcode and searches for companies at that location.
techAttributestechAttributeTagoptional
Searches for companies based on techAttribute tag. Accepts wild card characters, but not a leading wild card. Accepts multiple values by passing a comma-separated list.  Examples: enterprise_applications.commerce.zen_cart.zen_cart,it_governance.change_management.ibm.ibm_rational_doors
enterprise_applications.commerce.*,it_governance.change_management.ibm.*


Example Company Search Query

The following example shows a Company Search query. The input parameters include:

  • 5642 for IndustryClassification (Software Companies)
  • Florida for State

The Company Search query request should be structured as follows:

https://partnerapi.zoominfo.com/partnerapi/v4/company/search?pc=PartnerCode&IndustryClassification=5642&State=Florida&key=OAuthAccessToken

Note: To find a list of Industry Classification numbers, go to List of Values.

The Company Search XML output would appear as follows:

<?xml version="1.0" encoding="UTF-8"?>
<companySearchResponse xmlns="http://partnerapi.zoominfo.com/partnerapistatic/xsd/V4">
   <searchParameters>
      <parameter>
         <name>rpp</name>
         <value>2</value>
      </parameter>
      <parameter>
         <name>industryclassification</name>
         <value>5642</value>
      </parameter>
      <parameter>
         <name>state</name>
         <value>Florida</value>
      </parameter>
   </searchParameters>
   <totalResults>5000</totalResults>
   <maxResults>9931</maxResults>
   <companySearchResults>
      <companyRecord>
         <companyId>61493009</companyId>
         <zoomCompanyUrl>http://www.zoominfo.com/s/#!search/profile/company?companyId=61493009&amp;targetid=profile</zoomCompanyUrl>
         <companyDetailXmlUrl>https://partnerapi.zoominfo.com/partnerapi/v4/company/detail?CompanyID=61493009&amp;pc=ZoomTestQA&amp;key=4653d9b6-ace3-44b9-ad3c-f90606597817</companyDetailXmlUrl>
         <companyName>Citrix Systems Inc</companyName>
         <companyWebsite>www.citrix.com</companyWebsite>
         <companyAddress>
            <street>851 WEST CYPRESS CREEK ROAD</street>
            <city>Fort Lauderdale</city>
            <state>Florida</state>
            <zip>33309</zip>
            <country>United States</country>
         </companyAddress>
         <companyRevenue>$2.8 Billion</companyRevenue>
         <companyEmployeeCount>7500</companyEmployeeCount>
         <companySIC>73</companySIC>
         <companySIC>737</companySIC>
         <companySIC>7372</companySIC>
         <companySIC>36</companySIC>
         <companySIC>365</companySIC>
         <companySIC>3652</companySIC>
         <companySIC>7371</companySIC>
         <companySIC>78</companySIC>
         <companySIC>781</companySIC>
         <companySIC>7819</companySIC>
         <companyNAICS>541511</companyNAICS>
         <companyNAICS>5182</companyNAICS>
         <companyNAICS>5415</companyNAICS>
         <companyNAICS>511210</companyNAICS>
         <companyNAICS>33</companyNAICS>
         <companyNAICS>54151</companyNAICS>
         <companyNAICS>334</companyNAICS>
         <companyNAICS>3343</companyNAICS>
         <companyNAICS>512</companyNAICS>
         <companyNAICS>511</companyNAICS>
         <companyNAICS>541</companyNAICS>
         <companyNAICS>51</companyNAICS>
         <companyNAICS>5112</companyNAICS>
         <companyNAICS>518</companyNAICS>
         <companyNAICS>54</companyNAICS>
         <companyNAICS>51121</companyNAICS>
         <companyTicker>NASDAQ: CTXS</companyTicker>
         <companyDescription>Citrix (NASDAQ:CTXS) aims to power a world where people, organizations and things are securely connected and accessible to make the extraordinary possible. Its technology makes the world's apps and data secure and easy to access, empowering people to work anywhere and at any time. Citrix provides a complete and integrated portfolio of Workspace-as-a-Service, application delivery, virtualization, mobility, network delivery and file sharing solutions that enables IT to ensure critical systems are securely available to users via the cloud or on-premises and across any device or platform. With annual revenue in 2016 of $3.42 billion, Citrix solutions are in use by more than 400,000 organizations and 100 million users globally.</companyDescription>
         <companyIndustry>Software Development &amp; Design</companyIndustry>
         <companyIndustry>Software</companyIndustry>
         <companyIndustry>Engineering Software</companyIndustry>
         <companyIndustry>Custom Software &amp; Technical Consulting</companyIndustry>
      </companyRecord>
      <companyRecord>
         <companyId>345934637</companyId>
         <zoomCompanyUrl>http://www.zoominfo.com/s/#!search/profile/company?companyId=345934637&amp;targetid=profile</zoomCompanyUrl>
         <companyDetailXmlUrl>https://partnerapi.zoominfo.com/partnerapi/v4/company/detail?CompanyID=345934637&amp;pc=ZoomTestQA&amp;key=4653d9b6-ace3-44b9-ad3c-f90606597817</companyDetailXmlUrl>
         <companyName>Testking</companyName>
         <companyWebsite>www.testking.com</companyWebsite>
         <companyAddress>
            <street>2430 Estancia Blvd Suite 201</street>
            <city>Clearwater</city>
            <state>Florida</state>
            <zip>33761</zip>
            <country>United States</country>
         </companyAddress>
         <companyRevenue>$2.4 Million</companyRevenue>
         <companyEmployeeCount>12</companyEmployeeCount>
         <companySIC>737</companySIC>
         <companySIC>73</companySIC>
         <companyNAICS>5182</companyNAICS>
         <companyNAICS>51</companyNAICS>
         <companyNAICS>518</companyNAICS>
         <companyDescription>Testking has a proven track record of success Since 2002 with over 262,764 customers. We are confident about the quality of our products and thats why we offer a no hassle 30 day Money Back Guarantee. Should you fail your exam after purchasing our products we will refund the full amount.</companyDescription>
         <companyIndustry>Software Development &amp; Design</companyIndustry>
         <companyIndustry>Software</companyIndustry>
         <companyIndustry>Custom Software &amp; Technical Consulting</companyIndustry>
         <companyIndustry>Business Intelligence Software(BI)</companyIndustry>
      </companyRecord>
   </companySearchResults>
</companySearchResponse>

Output Parameters – Company Search

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

  • Group - The grouping for output field permissions. The permission groups configured for a partner determine the output fields present in a 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 won't beshown unless the 'outputFieldOptions' parameter contains this output field
CompanyFax

Fax number for the company. Optional:This output field 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 5 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
TopLevelIndustry The top level (and therefore least specific) industry grouping for the company. A company can have multiple top level industries. Optional:This output field won't be shown unless the 'outputFieldOptions' parameter contains “companyTopLevelIndustry”
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”
Industry
 The industry grouping for the company. A company can have multiple industries.
Hashtag
The list of hash tags for the displayed company. Each hash tag is composed of tag name and display label.
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”

Was this article helpful?

Can’t find what you’re looking for?

Contact our award-winning customer care team.