Hoover's API Version 3.0 - Company

Queries - Company Information

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

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 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\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\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\resultSet\firstHit First Hit now named firstHit instead of first-hit
\return\resultSet\hits Total Number of Hits in this Response
\return\resultSet\lastHit Last Hit now named lastHit instead of last-hit
\return\resultSet\totalHits Aggregate Total Number of Hits This is the total number of results the search returned now named totalHits instead of total-hit
\return\resultSet\hit\hitNumber Hit Number Now named hitNumber instead of number
\return\resultSet\hit\companyResults Company Results Now named companyResults instead of company-results
\return\resultSet\hit\companyResults\companyId Hoovers Company ID now named companyId instead of company-id
\return\resultSet\hit\companyResults\duns DUNS Number
\return\resultSet\hit\companyResults\companyName Company Name now named companyName instead of recname
\return\resultSet\hit\companyResults\locationType Location type such as Headquarters or branch
\return\resultSet\hi\companyResults\address1 Street Address
\return\resultSet\hit\companyResults\city Address City Now named city instead of addrcity
\return\resultSet\hit\companyResults\country Address Country Now named country instead of addrcountry
\return\resultSet\hit\companyResults\countryId Address Country ID Now named countryId instead of addrcountryid
\return\resultSet\hit\companyResults\stateOrProvince Address State/Province Now named stateOrProvince instead of addrstateprov ID Value from GetAdvancedSearchLookups
\return\resultSet\hit\companyResults\primaryUrl Primary URL
\return\resultSet\hit\companyResults\parentDuns Parent Company DUNS Number Now named parentDuns instead of parent-duns
\return\resultSet\hit\companyResults\ultimateParentDuns Ultimate Parent Company DUNS Number Now named ultimateParentDuns instead of ultimate-parent-duns
\return\resultSet\hit\companyResults\sales Annual Sales Now named sales instead of finsales
\return\companies\hit\companyResults\hqPhone Headquarters Phone Number Now named hqPhone instead of hqphone
\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 now named companySize instead of companysize
\bal\companySize\employeesTo Total Employees Upper Bound now named companySize instead of companysize
\bal\companySize\employeesGrowthFrom Total Employees Growth Percentage Lower Bound now named companySize instead of companysize
\bal\companySize\employeesGrowthTo Total Employees Growth Percentage Upper Bound now named companySize instead of companysize
\bal\companySize\employeesThisLocationFrom Employees at this Location Lower Bound now named companySize instead of companysize
\bal\companySize\employeesThisLocationTo Employees at this Location Upper Bound now named companySize instead of companysize
\bal\companySize\marketCapFrom Market Cap ($ mil) Lower Bound now named companySize instead of companysize
\bal\companySize\marketCapTo Market Cap ($ mil) Upper Bound now named companySize instead of companysize
\bal\companySize\salesFrom Annual Sales ($ mil) Lower Bound now named companySize instead of companysize
\bal\companySize\salesTo Annual Sales ($ mil) Upper Bound now named companySize instead of companysize
\bal\companySize\salesGrowthFrom Annual Sales Growth (%) Lower Bound now named companySize instead of companysize
\bal\companySize\salesGrowthTo Annual Sales Growth (%) Upper Bound now named companySize instead of companysize
\bal\companyType\location Location Type Now named companyType\locationType instead of companytype\location. ID Value from GetAdvancedSearchLookups
\bal\companyType\companyType Now named companyType\companyType instead of companytype\publicprivate. Valid values are either 1 (Public) or 2 (Private).
\bal\companyType\subsidiaryStatus Subsidiary Status Now named companyType\subsidiaryStatus instead of companytype\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 Now named underwriterId instead of underwriters. ID Value from GetAdvancedSearchLookups
\bal\industry\hooversIndustryCode Hoovers Industry Name Now named hooversIndustryCode instead of hooversindustryname. ID Value from GetAdvancedSearchLookups
\bal\industry\primaryOnly Primary Industry Only Boolean
\bal\industry\nAICS NAICS Code Enter at least two digits per code and separate multiple codes with commas; to range search, use a dash between codes.
\bal\industry\sIC US SIC Code Enter at least two digits per code and separate multiple codes with commas; to range search, use a dash between codes.
\bal\industry\uKSIC UK SIC Code Enter at least two digits per code and separate multiple codes with commas; to range search, use a dash between codes.
\bal\location\areacode US/Canada Area Code e.g. 512 or 210, 512, 212
\bal\location\city City e.g. Madrid or New York (single city only)
\bal\location\countryId Country Now named countryId instead of 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 Now named metropolitanId instead of metropolitan. ID Value from GetAdvancedSearchLookups
\bal\location\regionId World Region Now named regionId instead of region. ID Value from GetAdvancedSearchLookups
\bal\location\state US State/Canada Province
\bal\location\postalCode Postal Code e.g. 78701 or "SW1P 1JA" or "SW1" or Separate multiple ZIP codes by commas.
\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 Now named zipAreaSearch\scale instead of zipareascale. 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. Now named zipAreaSearch\radius instead of zipareawithin. 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) Now named zipAreaSearch\zipCode instead of zipareazipcode. 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 Now named auditorId instead of 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 Now named exchangeId instead of exchange. ID Value from GetAdvancedSearchLookups
\bal\specialtyCriteria\rankingId Rankings/Indices Now named rankingId instead of ranking. ID Value from GetAdvancedSearchLookups
\bal\specialtyCriteria\ukRegistration UK Registration Number Now named ukRegistration instead of uKRegistration. e.g. 3443456 or 3443456, 0764797
\bal\specialtyCriteria\ukVat UK Vat Number Now named ukVat instead of ukvat. 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 Now named ultimateParentDuns instead of ultimateParentDUNS. eg. 060902413 or 884364530
\bal\specialtyCriteria\primaryUrl Primary URL

2.3 Output Parameters

Field Name Value Notes
\return\companies\firstHit First Hit now named firstHit instead of first-hit
\return\companies\hits Total Number of Hits in this Response
\return\companies\lastHit Last Hit now named lastHit instead of last-hit
\return\companies\totalHits Aggregate Total Number of Hits This is the total number of results the search returned now named totalHits instead of total-hit
\return\companies\hit\hitNumber Hit Number Now named hitNumber instead of number
\return\companies\hit\companyResults Company Results Now named companyResults instead of company-results
\return\companies\hit\companyResults\companyId Hoovers Company ID now named companyId instead of company-id
\return\companies\hit\companyResults\duns DUNS Number
\return\companies\hit\companyResults\companyName Company Name now named companyName instead of recname
\return\companies\hit\companyResults\locationType Location type such as Headquarters or branch
\return\resultSet\hi\companyResults\address1 Street Address
\return\companies\hit\companyResults\city Address City Now named city instead of addrcity
\return\companies\hit\companyResults\country Address Country Now named country instead of addrcountry
\return\companies\hit\companyResults\countryId Address Country ID Now named countryId instead of addrcountryid
\return\companies\hit\companyResults\stateOrProvince Address State/Province Now named stateOrProvince instead of addrstateprov ID Value from GetAdvancedSearchLookups
\return\companies\hit\companyResults\primaryUrl Primary URL
\return\companies\hit\companyResults\parentDuns Parent Company DUNS Number Now named parentDuns instead of parent-duns
\return\companies\hit\companyResults\ultimateParentDunsNumber Ultimate Parent Company DUNS Number Now named ultimateParentDuns instead of ultimate-parent-duns
\return\companies\hit\companyResults\sales Annual Sales now named sales instead of finsales
\return\companies\hit\companyResults\hqPhone Headquarters Phone Number Now named hqPhone instead of hqphone
\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\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\dnbGlobalLinkage\parentDuns Hoover's ID of the company's immediate parent Now named parentDuns instead of immediateParent
\return\dnbGlobalLinkage\parentName Company name of this company's immediate parent. Now named parentName instead of immediateParentName
\return\name Company Name
\return\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\primarySIC US SIC Code now named primarySIC 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\allNAIC Collection NAICS codes for the company
\return\industries\allNAIC\item\naic NAIC code
\return\industries\allNAIC\item\description Description of the industry represented by the NAIC
\return\subsidiaryStatus Subsidiary Status Now returns status instead of boolean
\return\keyNumbersHistory\keyNumbers Annual and Quarterly 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\keyNumbers\sales Annual Sales This value is in US Dollars.
\return\keyNumbersHistory\keyNumbers\employeesAtThisLocation Employees at this Location
\return\keyNumbersHistory\keyNumbers\totalEmployeeGrowthPercent Total Employee Growth % for the Year
\return\keyNumbersHistory\keyNumbers\researchAndDevelopment R&D Expenses for the Year This value is in US Dollars.
\return\keyNumbersHistory\keyNumbers\advertising Advertising Expenses for the Year This value is in US Dollars.
\return\keyNumbersHistory\keyNumbers\employeesTotal Total Employees
\return\keyNumbersHistory\keyNumbers\record-type Sales Record Type Q = quarter, A = annual
\return\keyNumbersHistory\keyNumbers\fiscal-period Fiscal Period
\return\keyNumbersHistory\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\country Company Country
\return\locations\state Company State
\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\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\stateOfIncorporation State of Incorporation
\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\companyId Hoovers Company ID Now named companyId instead of company-id
\return\top-executives\official\coOfficialId Hoovers Official ID Now named coOfficialId instead of co-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\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

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 Now named companyId instead of company-id
\return\primaryLocation\address1 Company Address1 Now named primaryLocation instead of locations
\return\primaryLocation\address2 Company Address2 Now named primaryLocation instead of locations
\return\primaryLocation\city Company City Now named primaryLocation instead of locations
\return\primaryLocation\country Company Country Now named primaryLocation instead of locations and returns name of country instead of ID
\return\primaryLocation\state Company State Now named primaryLocation instead of locations
\return\primaryLocation\zip Postal code Now named primaryLocation instead of locations
\return\primaryLocation\zip4 Postal code Now named primaryLocation instead of locations
\return\primaryPhone\countryCode Address Country ID Now named primaryPhone instead of phones
\return\primaryPhone\areaCode Phone Number Area Code Now named primaryPhone instead of phones
\return\primaryPhone\phoneNumber Phone Number Now named primaryPhone instead of phones
\return\primaryURL Primary URL for the company

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

5.3 Output Parameters

Field Name Value Notes
\return\name Company Name
\return\companyId Hoovers Company ID Now named companyId instead of company-id
\return\duns DUNS Number
\return\parentDuns Parent Company DUNS Number Now named parentDuns instead of parent-duns
\return\ultimateParentDuns Ultimate Parent Company DUNS Number Now named ultimateParentDuns instead of ultimate-parent-duns
\return\revenue Revenue in millions of USD
\return\location-type Location Type (Headquarters, Branch, etc)
\return\city Company City
\return\state Company State
\return\country Country
\return\total-children Aggregate Total Number of Children for this unique ID
\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 Now named companyId instead of company-id
\return\children\child\duns Child DUNS Number
\return\children\child\parentDuns Child Parent Company DUNS Number Now named parentDuns instead of parent-duns
\return\children\child\ultimateParentDuns Child Ultimate Parent Company DUNS Number Now named ultimateParentDuns instead of ultimate-parent-duns
\return\children\child\revenue Child Revenue in millions of USD
\return\children\child\location-type Child Location Type (Headquarters, Branch, etc)
\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\recname 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 Now named parentDuns instead of parent-duns
\return\competitor\ultimateParentDuns Ultimate Parent Company DUNS Number Now named ultimateParentDuns instead of ultimate-parent-duns
\return\competitor\finsales Annual Sales
\return\competitor\companyId Hoovers Company ID Now named companyId instead of 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. Now named latestYearSales instead of currentYearSalesGrowth
\return/basicFinancialInformation/latestYearSales/sales The sales number in millions (USD) for the latest year sales growth. Now named latestYearSales instead of currentYearSalesGrowth
\return/basicFinancialInformation/oneYearSalesGrowthPct The one year sales growth percent.
\return/basicFinancialInformation/latestYearNetIncome/year The year for the current year net income. Now named latestYearNetIncome instead of currentYearNetIncome
\return/basicFinancialInformation/latestYearNetIncome/netIncome The net income for the current year in millions (USD). Now named latestYearNetIncome instead of currentYearNetIncome
\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.