Hoover's API Version 3.1 - Company

Queries - Company Information

IMPORTANT: All calls on this page require an API key

New features are highlighted.

1 Find Company By Keyword Search

1.1 Overview

Returns a set of companies based on keyword, along with basic identifying data for each company.

1.2 Input Parameters

Required fields are indicated with.

Field Name Value Notes
keyword String containing a keyword or phrase
maxRecords Between 1-200. Default = 20
hitOffset Greater than or equal to 0 but less than or equal to 10,000. Default = 0 Paging support, the firstHit returned will be hitOffset + 1. hitOffset is now zero-based.
searchBy One of the included enumeration called SearchByFields Can appear multiple times in the Request. Allows the user to search against just Company Name or Stock Symbol (or both) instead of the more generic search across many company fields if not included.
orderBy Values defined in WSDL, orderByTypes Relevant values for this search include:
  • Company (sorts by relevance; this is the default)
  • CompanyName
  • CityName
  • StateName
  • CountryName
  • SalesUS
sortDirection Values defined in WSDL: sortDirectionTypes - Ascending or Descending This has no effect without a valid orderBy.
returnSearchNavigation 'true' or 'false' If true navigators will be returned in the response to enable drill down into search results
searchNavigation/ employeeSearchNavigation/ employeeSearchNavigationValue An employee navigation link which can be fed back into other calls. The employee navigation link must be used to drill down by numbers of employee.
searchNavigation/ locationTypeSearchNavigation/ locationTypeSearchNavigationValue A location type navigation link which can be fed back into other calls. The location type navigation link must be used to drill down by location type.
searchNavigation/ companyTypeSearchNavigation/ companyTypeSearchNavigationValue A company type navigation link which can be fed back into other calls. The company type navigation link must be used to drill down by company type.
searchNavigation/ salesSearchNavigation/ salesSearchNavigationValue A sales navigation link which can be fed back into other calls. The sales navigation link must be used to drill down by sales.
searchNavigation/ locationSearchNavigation/ countryNavigation/ countryNavigationValue A country navigation link which can be fed back into other calls. The country navigation link must be used to drill down by country.
searchNavigation/ locationSearchNavigation/ countryNavigation/ stateNavigation/ stateNavigationValue A state/province navigation link which can be fed back into other calls. The state/province navigation link must be used to drill down by state/province.
searchNavigation/ locationSearchNavigation/ countryNavigation/ stateNavigation/ cityNavigation/ cityNavigationValue A city navigation link which can be fed back into other calls. The city navigation link must be used to drill down by city.
searchNavigation/ industrySearchNavigation/ industrySearchNavigationValue A industry navigation link which can be fed back into other calls. The industry navigation link must be used to drill down by industry.
searchNavigation/ industrySearchNavigation/ ussicSearchNavigationValue A UsSIC navigation link which can be fed back into other calls. The UsSIC navigation link must be used to drill down by UsSIC.
searchNavigation/ industrySearchNavigation/ naicsSearchNavigationValue A NaICS navigation link which can be fed back into other calls. The NaICS navigation link must be used to drill down by NaICS.

1.3 Output Parameters

Field Name Value Notes
Contains lists of navigation links The values in the navigation link lists must be fed back into other calls with the same keyword
\return\navigators\employeeNavigators\employeeNavigator\employeeNavigatorValue The value of a navigation link for number of employees To drill down on numbers of employees a value from this element must be fed back into another call with the same keyword.
\return\navigators\employeeNavigators\employeeNavigator\employeeNavigatorDescription The description of a navigation link for number of employees Could be used as a display value for the link
\return\navigators\locationTypeNavigators\locationTypeNavigator\locationTypeNavigatorValue The value of a navigation link for location type To drill down on location type a value from this element must be fed back into another call with the same keyword.
\return\navigators\locationTypeNavigators\locationTypeNavigator\locationTypeNavigatorDescription The description of a navigation link for location type Could be used as a display value for the link
\return\navigators\companyTypeNavigators\companyTypeNavigator\companyTypeNavigatorValue The value of a navigation link for company type To drill down on company type a value from this element must be fed back into another call with the same keyword.
\return\navigators\companyTypeNavigators\companyTypeNavigator\companyTypeNavigatorDescription The description of a navigation link for company type Could be used as a display value for the link
\return\navigators\salesNavigators\salesNavigator\salesNavigatorValue The value of a navigation link for final sales To drill down on sales a value from this element must be fed back into another call with the same keyword.
\return\navigators\salesNavigators\salesNavigator\salesNavigatorDescription The description of a navigation link for sales Could be used as a display value for the link
\return\navigators\locationNavigators\countryNavigators\countryNavigator\countryNavigatorValue The value of a navigation link for country To drill down on country a value from this element must be fed back into another call with the same keyword.
\return\navigators\locationNavigators\countryNavigators\countryNavigator\countryNavigatorDescription The description of a navigation link for country description Could be used as a display value for the link
\return\navigators\locationNavigators\countryNavigators\countryNavigator\stateProvinceNavigators\stateProvinceNavigator\stateProvinceNavigatorValue The value of a navigation link for state/province To drill down on state/province a value from this element must be fed back into another call with the same keyword.
\return\navigators\locationNavigators\countryNavigators\countryNavigator\stateProvinceNavigators\stateProvinceNavigator\stateProvinceNavigatorDescription The description of a navigation link for state/province description Could be used as a display value for the link
\return\navigators\locationNavigators\countryNavigators\countryNavigator\stateProvinceNavigators\stateProvinceNavigator\cityNavigators\cityNavigator\cityNavigatorValue The value of a navigation link for city To drill down on city a value from this element must be fed back into another call with the same keyword.
\return\navigators\locationNavigators\countryNavigators\countryNavigator\stateProvinceNavigators\stateProvinceNavigator\cityNavigators\cityNavigator\cityNavigatorDescription The description of a navigation link for city description Could be used as a display value for the link
\return\navigators\industryNavigators\industryNavigator\industryNavigatorValue The value of a navigation link for industry To drill down on industry a value from this element must be fed back into another call with the same keyword.
\return\navigators\industryNavigators\industryNavigator\industryNavigatorDescription The description of a navigation link for industry Could be used as a display value for the link
\return\navigators\industryNavigators\ussicNavigator\ussicNavigatorValue The value of a navigation link for UsSIC To drill down on UsSIC a value from this element must be fed back into another call with the same keyword.
\return\navigators\industryNavigators\ussicNavigator\ussicNavigatorDescription The description of a navigation link for UsSIC Could be used as a display value for the link
\return\navigators\industryNavigators\naicsNavigator\naicsNavigatorValue The value of a navigation link for NaICS To drill down on NaICS a value from this element must be fed back into another call with the same keyword.
\return\navigators\industryNavigators\naicsNavigator\naicsNavigatorDescription The description of a navigation link for NaICS Could be used as a display value for the link
\return\resultSet\firstHit First Hit
\return\resultSet\hits Total Number of Hits in this Response
\return\resultSet\lastHit Last Hit
\return\resultSet\totalHits Aggregate Total Number of Hits This is the total number of results the search returned
\return\resultSet\hit\hitNumber Hit Number
\return\resultSet\hit\companyResults Company Results
\return\resultSet\hit\companyResults\companyId Hoovers Company ID
\return\resultSet\hit\companyResults\duns DUNS Number
\return\resultSet\hit\companyResults\companyName Company Name
\return\resultSet\hit\companyResults\locationType Location type such as Headquarters or branch
\return\resultSet\hit\companyResults\address1 Street Address
\return\resultSet\hit\companyResults\city Address City
\return\resultSet\hit\companyResults\country Address Country
\return\resultSet\hit\companyResults\countryId Address Country ID
\return\resultSet\hit\companyResults\stateOrProvince Address State/Province ID Value from GetAdvancedSearchLookups
\return\resultSet\hit\companyResults\primaryUrl Primary URL
\return\resultSet\hit\companyResults\parentDuns Parent Company DUNS Number
\return\resultSet\hit\companyResults\ultimateParentDuns Ultimate Parent Company DUNS Number
\return\resultSet\hit\companyResults\sales Annual Sales
\return\companies\hit\companyResults\hqPhone Headquarters Phone Number
\return\companies\hit\companyResults\dbas List of DBA names
\return\companies\hit\companyResults\dbas\dba Doing Business As Company Name

2 Advanced Company Search

2.1 Overview

Returns search result of companies based on various different criteria

2.2 Input Parameters

Field Name Value Notes
\bal\maxrecords Max Records Between 1-200. Default = 20
\bal\hitOffset Greater than or equal to 0 but less than or equal to 10,000. Default = 0 Paging support, the firstHit returned will be hitOffset + 1. hitOffset is now zero-based.
\bal\sortdirection Sort Direction Values defined in WSDL: sortDirectionTypes - Ascending or Descending
\bal\orderby Order By Values defined in WSDL, orderByTypes
\bal\companySize\employeesFrom Total Employees Lower Bound
\bal\companySize\employeesTo Total Employees Upper Bound
\bal\companySize\employeesGrowthFrom Total Employees Growth Percentage Lower Bound
\bal\companySize\employeesGrowthTo Total Employees Growth Percentage Upper Bound
\bal\companySize\employeesThisLocationFrom Employees at this Location Lower Bound
\bal\companySize\employeesThisLocationTo Employees at this Location Upper Bound
\bal\companySize\marketCapFrom Market Cap ($ mil) Lower Bound
\bal\companySize\marketCapTo Market Cap ($ mil) Upper Bound
\bal\companySize\salesFrom Annual Sales ($ mil) Lower Bound
\bal\companySize\salesTo Annual Sales ($ mil) Upper Bound
\bal\companySize\salesGrowthFrom Annual Sales Growth (%) Lower Bound
\bal\companySize\salesGrowthTo Annual Sales Growth (%) Upper Bound
\bal\companyType\location Location Type ID Value from GetAdvancedSearchLookups
\bal\companyType\ownershipType Now named companyType\ownershipType instead of companytype\publicprivate. Values are 1 (Public), 21 (Owned by a Public Company) or 0 (Non-Public).
\bal\companyType\subsidiaryStatus Subsidiary Status Subsidiary or Not a Subsidiary
\bal\financialdata\advertisingExpenseFrom Ad Expense ($ mil) Lower Bound.
\bal\financialdata\advertisingExpenseTo Ad Expense ($ mil) Upper Bound.
\bal\financialdata\assetsFrom Assets ($ mil) Lower Bound.
\bal\financialdata\assetsTo Assets ($ mil) Upper Bound.
\bal\financialdata\filingDateFrom Filing Date Lower Bound MM/DD/YYYY
\bal\financialdata\filingDateTo Filing Date Upper Bound MM/DD/YYYY
\bal\financialdata\fiscalYearEnd Fiscal Year End Month
\bal\financialdata\incomeFrom Net Income ($ mil) Lower Bound.
\bal\financialdata\incomeGrowthFrom Net Income Growth (%) Lower Bound
\bal\financialdata\incomeGrowthTo Net Income Growth (%) Upper Bound
\bal\financialdata\incomeTo Net Income ($ mil) Upper Bound
\bal\financialdata\offerFrom US IPO Data - Offer Amount ($ mil.) Lower Bound
\bal\financialdata\offerTo US IPO Data - Offer Amount ($ mil.) Upper Bound
\bal\financialdata\priceRangeFrom US IPO Data - Price Range ($) Lower Bound
\bal\financialdata\priceRangeTo US IPO Data - Price Range ($) Upper Bound
\bal\financialdata\researchExpenseFrom R&D Expense ($ mil) Lower Bound
\bal\financialdata\researchExpenseTo R&D Expense ($ mil) Upper Bound
\bal\financialdata\tradingDateFrom Trading Date Lower Bound MM/DD/YYYY
\bal\financialdata\tradingDateTo Trading Date Upper Bound MM/DD/YYYY
\bal\financialdata\underwriterId Underwriters ID Value from GetAdvancedSearchLookups. It searches only the lead underwriter for the given underwriterId.
\bal\financialdata\marketingPreScreenScore Marketing pre-screen scores Enumerated values of either 'L' Low, 'M' Medium or 'H' High accepted. Allows for unique combinations of the preceding values from 0 to 3 times.
\bal\industry\hooversIndustryCode Hoovers Industry Name ID Value from GetAdvancedSearchLookups
\bal\industry\primaryOnly Primary Industry Only Boolean
\bal\industry\nAICS NAICS Code Enter only one code per element. Use multiple elements for multiple codes. Enter at least two digits per code. No CSV or Ranges can be specified
\bal\industry\nAICSRange\[from|to] NAICS Code Ranges Enter one or more range elements. Each range element must contain 'from' and a 'to' element.
\bal\industry\uSSIC US SIC Code Enter only one code per element. Use multiple elements for multiple codes. Enter at least two digits per code. No CSV or Ranges can be specified
\bal\industry\uSSICRange\[from|to] SIC Code Ranges Enter one or more range elements. Each range element must contain 'from' and a 'to' element.
\bal\industry\uKSIC UK SIC Code Enter only one code per element. Use multiple elements for multiple codes. Enter at least two digits per code. No CSV or Ranges can be specified
\bal\industry\uKSICRange\[from|to] UKSIC Code Ranges Enter one or more range elements. Each range element must contain 'from' and a 'to' element.
\bal\location\areacode US/Canada Area Code e.g. 512 or 210. To search with multiple area codes, create multiple area code elements one beneath another
\bal\location\streetAddress Street Address e.g. 1700 Pennsylvania Ave.
\bal\location\city City e.g. Madrid or New York (single city only)
\bal\location\countryId Country ID Value from GetAdvancedSearchLookups
\bal\location\globalState Global State/Province e.g Queensland or NY (single province/state only)
\bal\location\metropolitanId US Metropolitan Area ID Value from GetAdvancedSearchLookups
\bal\location\regionId World Region ID Value from GetAdvancedSearchLookups
\bal\location\usStateCanadaProvince US State/Canada Province
\bal\location\postalCode Postal Code e.g. 78701 or "SW1P 1JA" or "SW1". To search with multiple codes, create multipe Postal code elements one beneath another
\bal\location\usZipCodeRange\from US ZIP Code Lower Bound
\bal\location\usZipCodeRange\to US ZIP Code Upper Bound
\bal\location\zipAreaSearch\scale Units to search in: miles or kilometers e.g. Find results within 50 miles of 78745 (up to a maximum radius of 100 miles or 160 km). Use only one 5-digit ZIP code. Requires zipareawithin and zipareazipcode.
\bal\location\zipAreaSearch\radius # of miles or kilometers to search within. e.g. Find results within 50 miles of 78745 (up to a maximum radius of 100 miles or 160 km). Use only one 5-digit ZIP code. Requires zipareawithin and zipareazipcode.
\bal\location\zipAreaSearch\zipCode Zipcode to search within (78745 in the example) e.g. Find results within 50 miles of 78745 (up to a maximum radius of 100 miles or 160 km). Use only one 5-digit ZIP code. Requires zipareawithin and zipareazipcode.
\bal\location\latLongSearch\scale Units to search in: miles or kilometers Requires radius, latitude, and longitude.
\bal\location\latLongSearch\radius # of miles or kilometers to search within. Requires scale, latitude, and longitude.
\bal\location\latLongSearch\latitude latitude Requires scale, radius, and longitude.
\bal\location\latLongSearch\longitude longitude Requires scale, radius, and latitude.
\bal\location\allAny All or Any Matches on Location Criteria Matching ALL means a company would have to match each type of criteria entered. Matching ANY means that a company could match any single type of criteria entered. Valid values All or Any
\bal\location\ukCounty UK County ID Value from GetAdvancedSearchLookups
\bal\specialtyCriteria\auditorId Auditors ID Value from GetAdvancedSearchLookups
\bal\specialtyCriteria\companyKeyword Company Keyword e.g. laptops or China or acquired, merged, takeover
\bal\specialtyCriteria\duns DUNS Number
\bal\specialtyCriteria\exchangeId Exchange ID Value from GetAdvancedSearchLookups
\bal\specialtyCriteria\rankingId Rankings/Indices ID Value from GetAdvancedSearchLookups
\bal\specialtyCriteria\ukRegistration UK Registration Number e.g. 3443456 or 3443456, 0764797
\bal\specialtyCriteria\ukVat UK Vat Number e.g. 906565610 or 906565610, 466264724
\bal\specialtyCriteria\yearFoundingFrom Year of Founding or Change in Control Lower Bound YYYY
\bal\specialtyCriteria\yearFoundingTo Year of Founding or Change in Control (YYYY) Upper Bound YYYY
\bal\specialtyCriteria\ultimateParentDuns The ultimate parent DUNS number for a family of companies eg. 060902413 or 884364530
\bal\specialtyCriteria\primaryUrl Primary URL
\bal\specialtyCriteria\companyName Company Name

2.3 Output Parameters

Field Name Value Notes
\return\companies\firstHit First Hit
\return\companies\hits Total Number of Hits in this Response
\return\companies\lastHit Last Hit
\return\companies\totalHits Aggregate Total Number of Hits This is the total number of results the search returned
\return\companies\hit\hitNumber Hit Number
\return\companies\hit\companyResults Company Results
\return\companies\hit\companyResults\companyId Hoovers Company ID
\return\companies\hit\companyResults\duns DUNS Number
\return\companies\hit\companyResults\companyName Company Name
\return\companies\hit\companyResults\locationType Location type such as Headquarters or branch
\return\resultSet\hit\companyResults\address1 Street Address
\return\companies\hit\companyResults\city Address City
\return\companies\hit\companyResults\country Address Country
\return\companies\hit\companyResults\countryId Address Country ID
\return\companies\hit\companyResults\stateOrProvince Address State/Province ID Value from GetAdvancedSearchLookups
\return\companies\hit\companyResults\primaryUrl Primary URL
\return\companies\hit\companyResults\parentDuns Parent Company DUNS Number
\return\companies\hit\companyResults\ultimateParentDunsNumber Ultimate Parent Company DUNS Number
\return\companies\hit\companyResults\sales Annual Sales
\return\companies\hit\companyResults\hqPhone Headquarters Phone Number
\return\companies\hit\companyResults\dbas List of DBA names
\return\companies\hit\companyResults\dbas\dba Doing Business As Company Name

3 Get Company Detail

3.1 Overview

Returns detailed company information for a single company based on criteria of a DUNS or a Hoover's Company ID. Either DUNS or Hoover's Company ID are allowed now.

3.2 Input Parameters

Required fields are indicated with.

Field Name Value Notes
uniqueId Hoovers Company ID -OR- DUNS Number See note above

3.3 Output Parameters

Field Name Value Notes
\return\companyId Hoovers Company ID Now moved out from top-executives\official element and named companyId instead of company-id.
\return\duns Duns number of this company.
\return\companyType Company Type such as Public, Private, etc
\return\locationType Company Location Type such as Head Quarters, Single Location, etc
\return\ultimateParentDuns The Ultimate Parent DUNS number
\return\ultimateParentName The Ultimate Parent name corresponding to the ultimate parent DUNS number
\return\parentDuns Hoover's ID of the company's immediate parent Now named parentDuns instead of dnbGlobalLinkage\immediateParent
\return\parentName Company name of this company's immediate parent. Now named parentName instead of dnbGlobalLinkage\immediateParentName
\return\name Company Name
\return\dbaNames Contains all Doing Business As names
\return\dbaNames\dba Doing Business As
\return\industries\primaryHIC HIC Code Replaces hicName (HIC Name)
\return\industries\primaryNAICS NAICS Code now named primaryNAICS instead of nAICS
\return\industries\primaryUSSIC US SIC Code now named primaryUSSIC instead of sIAC
\return\industries\primaryUKSIC Primary UK SIC Code
\return\industries\allUKSIC Collection of all UK SIC Codes
\return\industries\allUKSIC\item\code UK SIC Code
\return\industries\allUKSIC\item\description Description of industry referred to
\return\industries\allUSSIC Collection of all US SIC Codes
\return\industries\allUSSIC\item\ussic US SIC Code
\return\industries\allUSSIC\item\description Description of the industry represented by the USSIC
\return\industries\allHIC Collection of all Hoovers Industry Codes
\return\industries\allHIC\item\hic Hoovers Industry Code
\return\industries\allHIC\item\description Description of the industry represented by the HIC
\return\industries\allNAICS Collection NAICS codes for the company Now named allNAICS instead of allNAIC
\return\industries\allNAICS\item\naics NAICS code Now named naics instead of naic
\return\industries\allNAICS\item\description Description of the industry represented by the NAICS Now named allNAICS instead of allNAIC
\return\subsidiaryStatus Subsidiary Status Now returns status instead of boolean
\return\keyNumbersHistory\annualKeyNumbersHistory Annual Financial Figures
\return\keyNumbersHistory\quarterlyKeyNumbersHistory Quarterly Financial Figures
\return\keyNumbersHistory\<annualKeyNumbersHistory OR quarterlyKeyNumbersHistory>\keyNumbers Financial Figures Previous version of API did not specify maxOccurs=unbounded, so generated client code was only able to get a single element. The API has changed to return an array or other collection.
\return\keyNumbersHistory\<annualKeyNumbersHistory OR quarterlyKeyNumbersHistory>\keyNumbers\sales Annual Sales This value is in US Dollars.
\return\keyNumbersHistory\<annualKeyNumbersHistory OR quarterlyKeyNumbersHistory>\keyNumbers\employeesAtThisLocation Employees at this Location
\return\keyNumbersHistory\<annualKeyNumbersHistory OR quarterlyKeyNumbersHistory>\keyNumbers\totalEmployeeGrowthPercent Total Employee Growth % for the Year
\return\keyNumbersHistory\<annualKeyNumbersHistory OR quarterlyKeyNumbersHistory>\keyNumbers\researchAndDevelopment R&D Expenses for the Year This value is in US Dollars.
\return\keyNumbersHistory\<annualKeyNumbersHistory OR quarterlyKeyNumbersHistory>\keyNumbers\advertising Advertising Expenses for the Year This value is in US Dollars.
\return\keyNumbersHistory\<annualKeyNumbersHistory OR quarterlyKeyNumbersHistory>\keyNumbers\employeesTotal Total Employees
\return\keyNumbersHistory\<annualKeyNumbersHistory OR quarterlyKeyNumbersHistory>\keyNumbers\record-type Sales Record Type Q = quarter, A = annual
\return\keyNumbersHistory\<annualKeyNumbersHistory OR quarterlyKeyNumbersHistory>\keyNumbers\fiscal-period Fiscal Period
\return\keyNumbersHistory\<annualKeyNumbersHistory OR quarterlyKeyNumbersHistory>\keyNumbers\periodEndMonth Period End Month
\return\locations Company Addresses Previous version of API did not specify maxOccurs=unbounded, so generated client code was only able to get a single element. The API has changed to return an array or other collection.
\return\locations\address1 Company Address
\return\locations\address2 Company Address Line 2
\return\locations\city Company City
\return\locations\state Company State
\return\locations\country Company Country Name Previous version of the API displayed Country Id in this element. API is changed to display CountryName.
\return\locations\countryId Company Country ID Previous version of the API displayed Country Id in 'country' element.
\return\locations\zip Company Zip Code
\return\locations\zip4 Company Zip Plus 4
\return\locations\latitude Latitude
\return\locations\longitude Longitude
\return\locations\latLongAccuracy Accuracy of latitude and longitude
\return\locations\addressType Address Type such as Primary, Headquarters, Mailing etc.
\return\ownershipYear Ownership Year
\return\phone Company Phone Numbers Phone as well as faxNumbers are now under this element.
\return\phones\[phoneNumber | faxNumber]\areaCode Phone Number Area Code
\return\phones\[phoneNumber | faxNumber]\countryCode Address Country ID
\return\phones\[phoneNumber | faxNumber]\phoneNumber Phone Number
\return\synopsis Company Description
\return\full-description Full Company Description
\return\stocks\tickerUS Ticker Symbol used for this company.
\return\stocks\exchangeInfoList Collection of exchange information.
\return\stocks\exchangeInfoList\exchangeInfo\country Country name where exchange is located.
\return\stocks\exchangeInfoList\exchangeInfo\tickerSymbol Ticker Symbol used for this company in this exchange.
\return\stocks\exchangeInfoList\exchangeInfo\exchangeName Exchange name where this company is traded.
\return\top-executives Top 3 Company Executives
\return\top-executives\official Company Executive
\return\top-executives\official\coOfficialId Hoovers Official ID
\return\top-executives\official\latest-position Most recent position information
\return\top-executives\official\latest-position\title Person Title  
\return\top-executives\official\latest-position\start-year Latest position start year
\return\top-executives\official\latest-position\end-year Latest position end year
\return\top-executives\official\latest-salary Most recent salary information
\return\top-executives\official\latest-salary\year Latest salary year  
\return\top-executives\official\latest-salary\salary Salary for the year, excluding bonus in USD  
\return\top-executives\official\latest-salary\total-salary Total compensation for the year, including any bonus or other compensation in USD
\return\top-executives\official\latest-salary\bonus Bonus for the year, in USD
\return\top-executives\official\person\full-name Person Full Name  
\return\top-executives\official\person\last-name Person Last Name  
\return\top-executives\official\person\first-name Person First Name  
\return\top-executives\official\person\middle-name Person Middle Name  
\return\top-executives\official\person\suffix Person Suffix  
\return\top-executives\official\person\prefix Person Prefix  
\return\top-executives\official\person\age Person Age  
\return\familyTreeLink Corporate Family Tree Link
\return\primaryURL Company Primary URL
\return\URLs Company Urls
\return\accountingFirm The accounting firm/auditor for this company.
\return\bankName The bank name for this company.
\return\creditScore The D&B Marketing Prescreen value for this company.
\return\keyFinancials Contains market value and income asset information.
\return\keyFinancials\marketValueInfo Contains market value information
\return\keyFinancials\marketValueInfo\marketValue Market value (in millions of USD) of this company.
\return\keyFinancials\marketValueInfo\marketValueDate Date of market valuation.
\return\keyFinancials\incomeAssets Contains income asset information.
\return\keyFinancials\incomeAssets\period Fiscal Period reporting date.
\return\keyFinancials\incomeAssets\assets Total assets (in millions of USD) of this company.
\return\keyFinancials\incomeAssets\salesGrowthPercent Sales growth in percent for this company.
\return\keyFinancials\incomeAssets\netIncome Net income (in millions of USD) of this company.
\return\keyFinancials\incomeAssets\netIncomeGrowthPercent Net income growth in percent of this company.
\return\ukSpecs UK-specific information.
\return\ukSpecs\uKRegistration UK Registration Number e.g. 3443456 or 3443456, 0764797
\return\ukSpecs\uKVAT UK Vat Number e.g. 906565610 or 906565610, 466264724
\return\ukSpecs\numberOfSubsidiaries Number of subsidiaries
\return\ukSpecs\numberOfSubsidiaries\domestic Number of subsidiaries in the UK
\return\numberOfPCs Number of PCs at the company
\return\spaceAtAddress Space in square feet at the location
\return\spaceAtAddressUnitOfMeasurement Unit of measurement for spaceAtAddress
\return\spaceAtAddressAccuracy Accuracy of spaceAtAddress field
\return\ownedOrLeased Indicates if the company's location is owned/leased
\return\manufacturingIndicator Indicates if the company is a manufacturer
\return\legalStatus Legal Status description for the company
\return\yearFounded Year the company was founded
\return\minorityOwned Indicates if the company is owned by a minority
\return\womenOwned Indicates if the company is owned by women

4 Get Company Detail Simple

4.1 Overview

Returns a reduced subset of company details for a given Hoover's Company ID or DUNS

4.2 Input Parameters

Required fields are indicated with.

Field Name Value Notes
uniqueId Hoovers Company ID -OR- DUNS Number

4.3 Output Parameters

Field Name Value Notes
\return\name Company Name
\return\companyId Hoovers Company ID
\return\primaryLocation\address1 Company Address1
\return\primaryLocation\address2 Company Address2
\return\primaryLocation\city Company City
\return\primaryLocation\country Company Country
\return\primaryLocation\state Company State
\return\primaryLocation\zip Postal code
\return\primaryLocation\zip4 Postal code
\return\primaryPhone\countryCode Address Country ID
\return\primaryPhone\areaCode Phone Number Area Code
\return\primaryPhone\phoneNumber Phone Number
\return\primaryURL Primary URL for the company
\return\legalStatus Legal Status description for the company
\return\yearFounded Year the company was founded
\return\minorityOwned Indicates if the company is owned by a minority
\return\womenOwned Indicates if the company is owned by women

5 Get Family Tree

5.1 Overview

Returns ultimate parent of the given DUNS or Hoover's Company ID and all of the children/descendants of that ultimate parent. Access to the the GetFamilyTree service operation has been restricted. Please contact your sales representative for access.

5.2 Input Parameters

Required fields are indicated with.

Field Name Value Notes
uniqueId Hoovers Company ID -OR- DUNS Number
filters Optional element used to filter the family tree results.
filters/city City Use multiple elements for multiple city values.
filters/state State Use multiple elements for multiple state values.
filters/country Country Use multiple elements for multiple country values.
filters/locationType Location Type Use multiple elements for multiple location type values.
filters/depthLimit The number of layers or levels of the family tree structure to return. An error will be returned if the value is less than 1.

5.3 Output Parameters

Field Name Value Notes
\return\name Company Name
\return\companyId Hoovers Company ID
\return\duns DUNS Number
\return\parentDuns Parent Company DUNS Number
\return\ultimateParentDuns Ultimate Parent Company DUNS Number
\return\revenue Revenue in millions of USD
\return\locationType Location Type Headquarters, Branch, etc. Now named locationType instead of location-type.
\return\city Company City
\return\state Company State
\return\country Country
\return\totalChildren Aggregate Total Number of Children for this unique ID Now named totalChildren instead of total-children.
\return\children This company's children Previous version of API did not specify maxOccurs=unbounded, so generated client code was only able to get a single element. The API has changed to return an array or other collection.
\return\children\child\number Hit Number of the specific child
\return\children\child\name Child Company Name
\return\children\child\companyId Child Hoovers Company ID
\return\children\child\duns Child DUNS Number
\return\children\child\parentDuns Child Parent Company DUNS Number
\return\children\child\ultimateParentDuns Child Ultimate Parent Company DUNS Number
\return\children\child\revenue Child Revenue in millions of USD
\return\children\child\locationType Child Location Type Headquarters, Branch, etc. Now named locationType instead of location-type.
\return\children\child\city Child Company City
\return\children\child\state Child Company State
\return\children\child\country Child Company Country
\return\children\child\children This company's children Previous version of API did not specify maxOccurs=unbounded, so generated client code was only able to get a single element. The API has changed to return an array or other collection.

6 Find Competitors By Company ID

6.1 Overview

Returns all competitors for a given Hoover's Company ID or DUNS

6.2 Input Parameters

Required fields are indicated with.

Field Name Value Notes
uniqueId Hoovers Company ID -OR- DUNS Number
topCompetitor true or false set to true if only top competitors are to be returned

6.3 Output Parameters

Field Name Value Notes
\return\competitor\companyName Competitor Company Name
\return\competitor\topcompetitor Top Competitor? true if the competitor is a top competitor to the given uniqueId
\return\competitor\addrcity Competitor City
\return\competitor\addrstateprov Competitor State/Province
\return\competitor\addrcountry Competitor Country
\return\competitor\addrcountryid Competitor Country ID
\return\competitor\duns DUNS Number
\return\competitor\parentDuns Parent Company DUNS Number
\return\competitor\ultimateParentDuns Ultimate Parent Company DUNS Number
\return\competitor\finsales Annual Sales
\return\competitor\companyId Hoovers Company ID

7 Company Financial Summary

7.1 Overview

This call returns a summary of financial data for a given company id.

7.2 Input Parameters

Required fields are indicated with.

Field Name Value Notes
uniqueId Company DUNS Number or Hoovers Company ID

7.3 Output Parameters

Element Name Value Notes
\return/basicFinancialInformation/companyType Type of company; public, private, etc.
\return/basicFinancialInformation/exchanges list of exchanges the company is traded on with stock symbol
\return/basicFinancialInformation/exchanges/exchange/tickerSymbol Ticker symbol for the company on the current exchange
\return/basicFinancialInformation/exchanges/exchange/exchangeName Name of the exchange the company is traded on.
\return/basicFinancialInformation/ticker Ticker symbol for the company
\return/basicFinancialInformation/location Type of location for the company; headquarters, branch office, etc.
\return/basicFinancialInformation/fiscalYearEnd Latest fiscal year end
\return/basicFinancialInformation/financialFilingsURL Link to Hoover's Online for financial filings data.
\return/basicFinancialInformation/latestYearSales/year The year for the latest year sales growth.
\return/basicFinancialInformation/latestYearSales/sales The sales number in millions (USD) for the latest year sales growth.
\return/basicFinancialInformation/oneYearSalesGrowthPct The one year sales growth percent.
\return/basicFinancialInformation/latestYearNetIncome/year The year for the current year net income.
\return/basicFinancialInformation/latestYearNetIncome/netIncome The net income for the current year in millions (USD).
\return/basicFinancialInformation/oneYearNetIncomeGrowthPct The one year net income growth percent.
\return/basicFinancialInformation/auditor The name of the financial auditor for this company.
\return/basicFinancialInformation/annualReportURL Company URL to get the annual report for this company.
\return/basicFinancialInformation/investorRelationsURL Company URL to get the investor relations info.
\return/annualIncomeStatements/latestYear Income statement info from the latest year available
\return/annualIncomeStatements/previousYears List of two previous year elements containing income statement information from the years prior to the latest year above.
\return/annualIncomeStatements/[previousYears/previousYear | latestYear]/year The year of the income statement data
\return/annualIncomeStatements/[previousYears/previousYear | latestYear]/revenue The revenue claimed in the income statement data in millions (USD)
\return/annualIncomeStatements/[previousYears/previousYear | latestYear]/grossProfit The gross profit in millions (USD) claimed on the income statement.
\return/annualIncomeStatements/[previousYears/previousYear | latestYear]/operatingIncome The operating income in millions (USD) claimed on the income statement.
\return/annualIncomeStatements/[previousYears/previousYear | latestYear]/totalNetIncome The total net income in millions (USD) claimed on the income statement.
\return/annualIncomeStatements/[previousYears/previousYear | latestYear]/dilutedEPS The diluted earnings per share claimed on the income statement.
\return/quarterlyIncomeStatements/latestQuarter An element containing the latest quarterly income information
\return/quarterlyIncomeStatements/previousQuarters List of previous two quarterly income information happening after the latest quarter above.
\return/quarterlyIncomeStatements/[previousQuarters/previousQuarter | latestQuarter]/quarterYear The year of the quarterly data
\return/quarterlyIncomeStatements/[previousQuarters/previousQuarter | latestQuarter]/quarterMonth The month of the quarterly data
\return/quarterlyIncomeStatements/[previousQuarters/previousQuarter | latestQuarter]/revenue The revenue for the quarter in millions (USD)
\return/quarterlyIncomeStatements/[previousQuarters/previousQuarter | latestQuarter]/grossProfit The gross profit for the quarter in millions (USD)
\return/quarterlyIncomeStatements/[previousQuarters/previousQuarter | latestQuarter]/operatingIncome The operating income for the quarter in millions (USD)
\return/quarterlyIncomeStatements/[previousQuarters/previousQuarter | latestQuarter]/totalNetIncome The total net income for the quarter in millions (USD)
\return/quarterlyIncomeStatements/[previousQuarters/previousQuarter | latestQuarter]/dilutedEPS The diluted earnings per share for the quarter
\return/comparisonToIndustryAndMarket Container for Industry and market comparison info
\return/comparisonToIndustryAndMarket/company Container for company comarison ratio info
\return/comparisonToIndustryAndMarket/company/priceSalesRatio Price Sales Ratio
\return/comparisonToIndustryAndMarket/company/priceEarningRatio Price Earnings Ratio
\return/comparisonToIndustryAndMarket/company/priceBookRatio Price Book Ratio
\return/comparisonToIndustryAndMarket/company/priceCashFlowRatio Price Cash Flow Ratio
\return/comparisonToIndustryAndMarket/industryMedian Container for Industry comparison ratio info
\return/comparisonToIndustryAndMarket/industryMedian/priceSalesRatio Price Sales Ratio
\return/comparisonToIndustryAndMarket/industryMedian/priceEarningRatio Price Earnings Ratio
\return/comparisonToIndustryAndMarket/industryMedian/priceBookRatio Price Book Ratio
\return/comparisonToIndustryAndMarket/industryMedian/priceCashFlowRatio Price Cash Flow Ratio
\return/comparisonToIndustryAndMarket/marketMedian Container for Market comparison ratio info
\return/comparisonToIndustryAndMarket/marketMedian/priceSalesRatio Price Sales Ratio
\return/comparisonToIndustryAndMarket/marketMedian/priceEarningRatio Price Earnings Ratio
\return/comparisonToIndustryAndMarket/marketMedian/priceBookRatio Price Book Ratio
\return/comparisonToIndustryAndMarket/marketMedian/priceCashFlowRatio Price Cash Flow Ratio
\return/topCompetitors Collection of the top 3 competitors for this company.
\return/topCompetitors/competitor1 Competitor Data.
\return/topCompetitors/competitor2 Competitor Data.
\return/topCompetitors/competitor3 Competitor Data.
\return/topCompetitors/competitor[1,2, or 3]/companyName Competitor name.
\return/topCompetitors/competitor[1,2, or 3]/annualSales The sales number in millions (USD) for this competitor.
\return/topCompetitors/competitor[1,2, or 3]/employees The number of employees at this competitor.
\return/topCompetitors/competitor[1,2, or 3]/marketCap Competitor's market cap in millions (USD).

8 Company Financial Comparison

8.1 Overview

This call returns financial comparison data for a given company id.

8.2 Input Parameters

Required fields are indicated with.

Field Name Value Notes
uniqueId Company DUNS Number or Hoovers Company ID

8.3 Output Parameters

Element Name Value Notes
\return/profitabilityComparison Profitability comparison data for industry median, market median, and the company.
\return/profitabilityComparison/[company, industryMedian, or marketMedian]/pctGrossProfitMargin Gross profit margin.
\return/profitabilityComparison/[company, industryMedian, or marketMedian]/pctPreTaxProfitMargin Pre-tax profit margin.
\return/profitabilityComparison/[company, industryMedian, or marketMedian]/pctNetProfitMargin Net profit margin.
\return/profitabilityComparison/[company, industryMedian, or marketMedian]/pctReturnOnEquity Return on equity.
\return/profitabilityComparison/[company, industryMedian, or marketMedian]/pctReturnOnAssets Return on assets.
\return/profitabilityComparison/[company, industryMedian, or marketMedian]/pctReturnOnInvestedCapital Return on invested capital.
\return/valuationComparison Valuation comparison data for industry median, market median, and the company.
\return/valuationComparison/[company, industryMedian, or marketMedian]/priceSalesRatio Price/Sales ratio.
\return/valuationComparison/[company, industryMedian, or marketMedian]/priceEarningsRatio Price/Earnings ratio.
\return/valuationComparison/[company, industryMedian, or marketMedian]/priceBookRatio Price/Book ratio.
\return/valuationComparison/[company, industryMedian, or marketMedian]/priceCashFlowRatio Price/Cash Flow ratio.
\return/operationsComparison Operations comparison data for industry median, market median, and the company.
\return/operationsComparison/[company, industryMedian, or marketMedian]/daysOfSalesOutstanding Days of sales outstanding.
\return/operationsComparison/[company, industryMedian, or marketMedian]/inventoryTurnover Inventory turnover.
\return/operationsComparison/[company, industryMedian, or marketMedian]/daysCostOfGoodsSoldInInventory Days cost of goods sold in inventory.
\return/operationsComparison/[company, industryMedian, or marketMedian]/assetTurnover Asset turnover.
\return/operationsComparison/[company, industryMedian, or marketMedian]/netReceivablesTurnoverFlow Net receivables turnover flow.
\return/operationsComparison/[company, industryMedian, or marketMedian]/pctEffectiveTaxRate Effective tax rate.
\return/financialComparison Financial comparison data for industry median, market median, and the company.
\return/financialComparison/[company, industryMedian, or marketMedian]/currentRatio Current Ratio
\return/financialComparison/[company, industryMedian, or marketMedian]/quickRatio Quick Ratio
\return/financialComparison/[company, industryMedian, or marketMedian]/leverageRatio Leverage Ratio
\return/financialComparison/[company, industryMedian, or marketMedian]/totalDebtToEquity Total Debt/Equity
\return/financialComparison/[company, industryMedian, or marketMedian]/interestCoverage Interest Coverage
\return/perShareDataComparison Per Share data for industry median, market median, and the company.
\return/perShareDataComparison/[company, industryMedian, or marketMedian]/revenuePerShare Revenue per share.
\return/perShareDataComparison/[company, industryMedian, or marketMedian]/dividendsPerShare Dividends per share.
\return/perShareDataComparison/[company, industryMedian, or marketMedian]/cashFlowPerShare Cash flow per share.
\return/perShareDataComparison/[company, industryMedian, or marketMedian]/workingCapitalPerShare Working capital per share.
\return/perShareDataComparison/[company, industryMedian, or marketMedian]/longTermDebtPerShare Long term debt per share.
\return/perShareDataComparison/[company, industryMedian, or marketMedian]/bookValuePerShare Book value per share.
\return/perShareDataComparison/[company, industryMedian, or marketMedian]/totalAssetsPerShare Total assets per share.
\return/growthComparison Growth Comparison for industry median, market median, and the company.
\return/growthComparison/[company, industryMedian, or marketMedian]/pctTwelveMonthRevenueGrowth 12-Month Revenue Growth
\return/growthComparison/[company, industryMedian, or marketMedian]/pctTwelveMonthNetIncomeGrowth 12-Month Net Income Growth
\return/growthComparison/[company, industryMedian, or marketMedian]/pctTwelveMonthEpsGrowth 12-Month EPS Growth
\return/growthComparison/[company, industryMedian, or marketMedian]/pctTwelveMonthDividendGrowth 12-Month Dividend Growth
\return/growthComparison/[company, industryMedian, or marketMedian]/pctThirtySixMonthRevenueGrowth 36-Month Revenue Growth
\return/growthComparison/[company, industryMedian, or marketMedian]/pctThirtySixMonthNetIncomeGrowth 36-Month Net Income Growth
\return/growthComparison/[company, industryMedian, or marketMedian]/pctThirtySixMonthEpsGrowth 36-Month EPS Growth
\return/growthComparison/[company, industryMedian, or marketMedian]/pctThirtySixMonthDividendGrowth 36-Month Dividend Growth

9 Company Market Data

9.1 Overview

This call returns financial market data for a given company id.

9.2 Input Parameters

Required fields are indicated with.

Field Name Required Notes
uniqueId Company DUNS Number or Hoovers Company ID

9.3 Output Parameters

Element Name Value Notes
\return/currentInformation/lastCloseDate Date of the reported last close price.
\return/currentInformation/lastCloseAmount The reported last close price.
\return/currentInformation/fiftyTwoWeekHigh The fifty two week stock price high.
\return/currentInformation/fiftyTwoWeekLow The fifty two week stock price low.
\return/currentInformation/sixtyMonthBeta The sixty month beta.
\return/currentInformation/marketCap The market cap for the company in millions.
\return/currentInformation/sharesOutstanding The shares outstanding for the company in millions.
\return/currentInformation/dividendRate The dividend rate for the company.
\return/currentInformation/dividendYield The dividend yield for the company.
\return/currentInformation/numOfInstitutionalHolders The number of institutions owning this companies stock.
\return/currentInformation/latestShortInterestRatio The short interest ratio for this company.
\return/currentInformation/priceSalesRatio Price to sales ratio.
\return/currentInformation/priceBookRatio Price to book ratio.
\return/currentInformation/priceEarningsRatio Price to earnings ratio.
\return/currentInformation/priceCashFlowRatio Price to cash flow ratio.
\return/currentInformation/pctReturnOnAssets Return on assets as a percentage.
\return/currentInformation/pctReturnOnEquity Return on equity as a percentage.
\return/currentInformation/currentRatio Current ratio for this company.
\return/currentInformation/longTermDebtToEquity Long term debt to equity ratio for this company.
\return/currentInformation/pctOwnedByInstitutions Percentage of the company stock owned by institutions.
\return/currentInformation/latestNetInsiderTransactions The amount of recent insider transactions.
\return/growthRates/[twelveMonth OR thirtySixMonth OR sixtyMonth]/pctRevenueGrowth Percentage of revenue growth for 12, 36, and 60 months respectively.
\return/growthRates/[twelveMonth OR thirtySixMonth OR sixtyMonth]/pctEpsGrowth Percentage of EPS growth for 12, 36, and 60 months respectively.
\return/growthRates/[twelveMonth OR thirtySixMonth OR sixtyMonth]/pctDividendGrowth Percentage of dividend growth for 12, 36, and 60 months respectively.