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:

http://partnerapi.zoominfo.com/partnerapi/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
  • 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.
Group
Field Name
Required
Value
Notes
Key
Default
pc
required

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

String consisting of 5 parameters concatenated together, and then encrypted with MD5. Parameters are:
 1) first 2 characters of every search term in sequential order, based on the order presented in the input parameters table for each query
 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
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
no
Results Per Page
rpp
optional

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

Provides the results for the given page, used in conjunction with rpp
no
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.
no
SortOrder
optional
asc or desc
Default value is desc. SortBy is required if SortOrder is specified.
no
Company Name
companyName
optional

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

Search for people whose companies match the given description.
yes
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.
yes
IndustryKeywords
optional

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

(#### is a SIC or NAICS code)
Search for companies classified as a given search code value. Each code represents an industry area.no
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.
no
Company Size
RevenueClassificationMin
optional
See list of values.
Minimum revenue dollar amount of a company. Use this parameter with RevenueClassificationMax to set a range.
yes
RevenueClassificationMax
optional
See list of values.
Maximum revenue dollar amount of a company. Use this parameter with RevenueClassificationMin to set a range.
yes
EmployeeSizeClassificationMin
optional
See list of values.
Minimum employee size of a company. Use this parameter with EmployeeSizeClassificationMax to set a range.
yes
EmployeeSizeClassificationMax
optional
See list of values.
Maximum employee size of a company. Use this parameter with EmployeeSizeClassificationMin to set a range.
yes
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.
yes
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.

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

yes
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.
yes
RadiusMiles
optional
See list of values.
Used in conjunction with ZipCode, designates how far in miles from zip code to include in search.
yes
location
optional

Accepts any address, city, state, country, or zipcode and searches for companies at that location.
yes
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.*
no


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:

http://partnerapi.zoominfo.com/partnerapi/company/search?pc=PartnerCode&IndustryClassification=5642&State=Florida&key=EncryptedKey

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

The Company Search XML output would appear as follows:

<CompanySearchRequest xmlns="http://partnerapi.zoominfo.com/partnerapistatic/xsd/V1/CompanyQuery.xsd">
 <SearchParameters>
 <Parameter>
 <Name>industryclassification</Name>
 <Value>5642</Value>
 </Parameter>
 <Parameter>
 <Name>state</Name>
 <Value>Florida</Value>
 </Parameter>
 </SearchParameters>
 <TotalResults>5000</TotalResults>
 <MaxResults>18958</MaxResults>
 <CompanySearchResults>
 <CompanyRecord>
 <CompanyID>61493009</CompanyID>
 <ZoomCompanyUrl> http://www.zoominfo.com/#!search/profile/company?companyId=61493009&targetid=profile </ZoomCompanyUrl>
 <CompanyDetailXmlUrl> http://partnerapi.zoominfo.com/partnerapi/company/detail?query_type=company_detail&CompanyID=61493009&pc=PartnerCode&key=EncryptedKey </CompanyDetailXmlUrl>
 <CompanyName>Citrix Systems Inc</CompanyName>
 <CompanyTicker>NASDAQ: CTXS</CompanyTicker>
 <Website>www.citrix.com</Website>
 <CompanyAddress>
 <Street>851 West Cypress Creek Road</Street>
 <City>Fort Lauderdale</City>
 <State>Florida</State>
 <Zip>33309</Zip>
 <CountryCode>United States</CountryCode>
 </CompanyAddress>
 <CompanyDescription> Citrix Systems, Inc. designs, develops and market technology solutions that allow applications to be delivered, supported, and shared on-demand with high performance, enhanced security, and improved total cost of ownership (TCO). The Company markets and licenses its products through multiple channels, such as value-added resellers (VARs), channel distributors, system integrators (Sis), independent software vendors (ISVs), its Websites and original equipment manufacturers (OEMs). The Company designs, develops, markets, sells and supports multiple products in an IT market category called Application Delivery Infrastructure. Its product family brand for all its infrastructure solutions is the Citrix Delivery Center. In October 2008, it acquired all of the issued and outstanding securities of Vapps, Inc. (Vapps).
 (Source: 10-K) </CompanyDescription>
 <Revenue>$1.6 Billion</Revenue>
 <Employees>4816</Employees>
 <Industry>Software Development & Design</Industry>
 <Industry>Software</Industry>
 <Industry>Consumer Electronics</Industry>
 <Industry>Consumer Goods</Industry>
 <Industry>Telecommunication Equipment</Industry>
 <Industry>Manufacturing</Industry>
 <Industry>Engineering Software</Industry>
 <Industry>Content & Collaboration Software</Industry>
 </CompanyRecord>
 <CompanyRecord>
 <CompanyID>39354715</CompanyID>
 <ZoomCompanyUrl> http://www.zoominfo.com/#!search/profile/company?companyId=39354715&targetid=profile </ZoomCompanyUrl>
 <CompanyDetailXmlUrl> http://partnerapi.zoominfo.com/partnerapi/company/detail?query_type=company_detail&CompanyID=39354715&pc=PartnerCode&key=EncryptedKey </CompanyDetailXmlUrl>
 <CompanyName>Ultimate Software incorporated</CompanyName>
 <CompanyTicker>NASDAQ: ULTI</CompanyTicker>
 <Website>www.ultimatesoftware.com</Website>
 <CompanyAddress>
 <Street>2000 Ultimate Way</Street>
 <City>Weston</City>
 <State>Florida</State>
 <Zip>33326</Zip>
 <CountryCode>United States</CountryCode>
 </CompanyAddress>
 <CompanyDescription> The Ultimate Software Group, Inc. (Ultimate Software) designs, markets, implements and supports human resources (HRs), payroll and talent management solutions in the United States and Canada. The Company's UltiPro Software (UltiPro) is a Internet-based solution designed to deliver the functionality businesses need to manage the complete employment life cycle from recruitment to retirement. The solution includes feature-sets for talent acquisition and onboarding, HR management and compliance, benefits management and online enrollment, payroll, performance management, salary planning and budgeting, reporting and analytical decision-making tools, time and attendance, and a self-service Web portal for executives, managers, administrators and employees. (Source: 10-K) </CompanyDescription>
 <Revenue>$269.2 Million</Revenue>
 <Employees>1328</Employees>
 <Industry>Software Development & Design</Industry>
 <Industry>Software</Industry>
 <Industry>Engineering Software</Industry>
 <Industry>Financial, Legal & HR Software</Industry>
 </CompanyRecord>
 <CompanyRecord>
 <CompanyID>66453522</CompanyID>
 <ZoomCompanyUrl> http://www.zoominfo.com/#!search/profile/company?companyId=66453522&targetid=profile </ZoomCompanyUrl>
 <CompanyDetailXmlUrl> http://partnerapi.zoominfo.com/partnerapi/company/detail?query_type=company_detail&CompanyID=66453522&pc=PartnerCode&key=EncryptedKey </CompanyDetailXmlUrl>
 <CompanyName>Web Internet LLC</CompanyName>
 <CompanyTicker>NASDAQ: WWWW</CompanyTicker>
 <Website>www.web.com</Website>
 <CompanyAddress>
 <Street>12808 Gran Bay Parkway West</Street>
 <City>Jacksonville</City>
 <State>Florida</State>
 <Zip>32258</Zip>
 <CountryCode>United States</CountryCode>
 </CompanyAddress>
 <CompanyDescription> Web.com, Inc., formerly Website Pros, Inc. is a provider of do-it-for-me and do-it-yourself Website building tools, online marketing, lead generation and technology solutions that enable small and medium-sized businesses to build and maintain an online presence. The Company offers a range of online services, including online marketing and advertising, local search, search engine marketing, search engine optimization, lead generation, home contractor specific leads, Website design and publishing, logo and brand development and eCommerce solutions, meeting the needs of small businesses anywhere along their lifecycle. On June 18, 2008, the Company acquired certain assets from LogoYes.com and Design Logic, Inc (collectively LogoYes). In April 2009, the Company acquired Solid Cactus, an eCommerce site builder and solutions provider. </CompanyDescription>
 <Revenue>$199.2 Million</Revenue>
 <Employees>1800</Employees>
 <Industry>Software Development & Design</Industry>
 <Industry>Software</Industry>

 <Industry>Business Services</Industry>
 <Industry>Search Engines & Internet Portals</Industry>
 <Industry>Media & Internet</Industry>
 <Industry>Content & Collaboration Software</Industry>
 </CompanyRecord>
 ... </CompanySearchResults>
</CompanySearchRequest>

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.