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
  • companyids
  • companysic
  • companynaics
  • companymergeracquisition
  • companyranking
  • companysubsidiary
  • companystructure
  • continent
  • isdefunct
  • acquiredByCompany
  • orderHashtags
  • companyType
  • techAttributes 
  • similarCompanies
  • funding
  • lowestSICSOnly
  • lowestNAICSOnly
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 IndustryClassification is specified, the returned records are sorted by decreasing relevance
  • When the SortBy is not specified and industryKeywords is specified, the returned records are sorted by decreasing relevance
  • When the SortBy is not specified and hashtagField is specified, the returned records are sorted by decreasing 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.
Company ID or Company Domain
companyIds
optional

The company's ZoomInfo ID. Accepts multiple values by passing a comma-separated list.
Company Attribute
excludeDefunctCompanies
optional
true or false
Include or exclude defunct companies. Default is false.
hashtagField
optional

Searches for companies based on company attributes.  For example, #100_plus_general_management will only return companies that have 100 or more employees in a general management role.  Accepts multiple values by passing a comma-separated list.
isPublic
optional
true or false
Search for companies that are either public or not.
pubPrivateSectors
optional
Public, Private, Education, Not_For_Profit, Nonprofit, Government
Search for companies of one or more type in Upper Case. For Example: "NOT_FOR_PROFIT". Accepts multiple values by passing a comma-separated list.
Company Structure
ultimateParentId
optional

Return companies which have only the specified "ultimateParentId".
parentId
optional

Return companies which have only the specified "parentId".
subUnitType
optional
acquisition, division, formernewname, location, subsidiary, unspecified
Return companies which have only the specified "sub unit types".
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.
IndustryCode
optional
SIC####
NAICS#### 

(#### is a SIC or NAICS code)
Search for companies classified as a given search code value. Each code represents an industry area.
IndustryCodeAnd
optional
SIC####
NAICS####

(#### is a SIC or NAICS code)
Similar to IndustryCode, different only in that companies which have all the listed IndustryCodes will be returned.
primaryIndustriesOnly
optional
true or false
When this parameter is set to "true", any result returned must have one of the specified industries as the top one or two industries. If no industries are specified, then the "primaryIndustriesOnly" input parameter will be ignored.
Default is false.
companyType
optional
public,
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.
RevenueClassification
optional
See list of values.
Accepts a comma separated list of revenue ranges for a company. Cannot be used with RevenueClassificationMin and/or RevenueClassificationMax.
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.
EmployeeSizeClassification
optional
See list of values.
Accepts a comma separated list of employee size ranges for a company. Cannot be used with EmployeeCompanySizeClassificationMin and/or EmployeeSizeClassificationMax.
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.
continent
optional
North America, Europe, Africa, Asia, South America, Oceania
Searches for companies in one or more continents (ex. Asia). Accepts multiple values by passing a comma-separated list.
techAttributes
techAttributeTag
optional

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.*
techAttributeTagAnd
optional

Similar to techAttributeTag, different only in that companies which have all the listed techAttributes will be returned.
FundingfundingStartDate
optional

Start Date of the funding, accepts date in this format: YYYY-MM-DD (no time can be specified and Eastern timezone is assumed)
fundingEndDate
optional

End Date of the funding, accepts date in this format: YYYY-MM-DD (no time can be specified and Eastern timezone is assumed)
  • If fundingStartDate and fundingEndDate are both entered, they will be used as a range (start date after end date returns an error)
  • If start date and end date are the SAME then we will use the exact date
fundingDaysInPast
optional

This parameter is for people who want to find companies with funding in the past N days. This parameter would NOT be allowed to be used with either of the two date parameters
fundingMinIn000s
optional

If fundingMinIn000s alone is entered, the range will be this value in 1000s or greater. It accepts numbers in 1000s (i.e. 1 = 1000, 256 = 256,000)
fundingMaxIn000s
optional

If fundingMaxIn000s alone is entered, the range will be this value in 1000s or less.

It accepts numbers in 1000s (i.e. 1 = 1000, 256 = 256,000)

  • If fundingMinIn000s and fundingMaxIn000s are both entered, they will be used as a range in 1000s (min greater that max returns an error)
  • If fundingMinIn000s and fundingMaxIn000s are both entered as the same value, this value will be used as an exact value in 1000s


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.
hashtagField

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.