Sorry, we didn't find any relevant articles for you.
Please fill out the contact form below and we will reply as soon as possible.
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?
The table below shows input parameters that can be used in Company Search queries. Parameter descriptions are grouped as follows:
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/v2/token |
||
outputFieldOptions |
optional |
Company Search Query has the following optional output fields:
|
||
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.
|
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 companies that 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 companies 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 companies 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 (aka technology product Ids) . Exact tags represent techAttribute products and wild carded values represent multiple products. Accepts multiple values by passing a comma-separated list. Values can be entered in any of the following formats:
6356 332.7.11831.*, 332.7.*,6356 *.11831.*, 6356 |
|
techAttributesToOutput |
optional | Values can be entered in the same format as techAttributeTag. This input is used to specify which technologies are returned from techAttributes. Be sure to use in conjunction with techAttributes in outputFieldOptions. |
||
techAttributeTagAnd |
optional |
Similar to techAttributeTag, different only in that companies which have all the listed techAttributes will be returned. |
||
Funding |
fundingStartDate |
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)
|
||
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)
|
The following example shows a Company Search query. The input parameters include:
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&targetid=profile</zoomCompanyUrl> <companyDetailXmlUrl>https://partnerapi.zoominfo.com/partnerapi/v4/company/detail?CompanyID=61493009&pc=ZoomTestQA&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 & Design</companyIndustry> <companyIndustry>Software</companyIndustry> <companyIndustry>Engineering Software</companyIndustry> <companyIndustry>Custom Software & Technical Consulting</companyIndustry> </companyRecord> <companyRecord> <companyId>345934637</companyId> <zoomCompanyUrl>http://www.zoominfo.com/s/#!search/profile/company?companyId=345934637&targetid=profile</zoomCompanyUrl> <companyDetailXmlUrl>https://partnerapi.zoominfo.com/partnerapi/v4/company/detail?CompanyID=345934637&pc=ZoomTestQA&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 & Design</companyIndustry> <companyIndustry>Software</companyIndustry> <companyIndustry>Custom Software & Technical Consulting</companyIndustry> <companyIndustry>Business Intelligence Software(BI)</companyIndustry> </companyRecord> </companySearchResults> </companySearchResponse>
The table below shows output parameters that can be used in Company Search queries. Parameter descriptions are grouped as follows:
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” |
Contact our award-winning customer care team.