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/v2/token
	outputFieldOptions	optional		Company Search Query has the following optional output fields: companyPhone companyDomains companyFax companyRevenueNumeric companyRevenueRange companyEmployeeRange companyTopLevelIndustry companyLogo companyHashtags companyAttributeValues companyProductsAndServices companyids companysic companynaics companymergeracquisition companyranking companysubsidiary companystructure continent isdefunct acquiredByCompany numericFull orderHashtags companyType socialURLs techAttributes similarCompanies funding lowestSICSOnly lowestNAICSOnly familyTree (Caution: family trees may be very large and therefore adding these to your output may affect performance) 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
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
Sort	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: 1) Product (Search companies for this technology product) 2) ParentCategory.Category.Vendor.* (Search companies with products under specified ParentCategory, Category and Vendor) 3) ParentCategory.Category.* (Search companies with products under specified ParentCategory, Category) 4) .Vendor. (Search companies with products under specified Vendor) Examples: 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) 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”

Company Search

Input Parameters – Company Search

Example Company Search Query

Output Parameters – Company Search

Quick Jump

Can’t find what you’re looking for?