Current Development Version - Hoover's API Version 2.0
New features are highlighted.
1. API Overview
The Hoover's API allows you to integrate Hoover's people and company data into your own applications. The API Documentation covers all aspects of the Hoover's API. If you have any questions, please post them on the Ask a Question section of the forum.
1.1 API URL and WSDL
Due to a bug in Axis2, we have removed the WSDL from its previous location and placed it at http://hapi-dev.hoovers.com/axis2/HooversAPI-20/Hapi.wsdl. The WSDL for the Hoover's API can be found at http://hapi-dev.hoovers.com/axis2/HooversAPI-20/Hapi.wsdl. To make a call to the Hoover's API, send your SOAP request (don't forget your developer key in the SOAP Header) to http://hapi-dev.hoovers.com/axis2/services/HooversAPI-20.
1.2 API Use and Timeouts
On occasion, your application may experience a timeout when calling the Hoover's API. The timeout will appear as an HTTP 403 error. It could be that you exceeded the number of queries per second or day in your Terms of Service or it is possible that you were denied access due to the aggregate queries per second limit. The aggregate queries per second limit is a fail-safe of the Hoover's API, where the system denies all requests over a certain amount per second (set by Hoover's) to ensure the stability of the Hoover's environment.
In case the number of calls per second or the aggregate queries per second is exceeded, you will receive a timeout. Write your application to re-attempt the request. However, if the application tries several times and cannot get through, please allow your request to fail and return an error. Otherwise, your application will be stuck calling the Hoover's API over and over again (which is not a good thing for you or Hoover’s).
1.3 API Sample Code
Sample code which demonstrates how to consume the Hoover's API are available for .Net, Java and PHP.
Updated for Version 2.0
.Net Sample (zip file)
Java Sample (zip file)
PHP Sample (zip file)
1.4 API Versioning
The Hoover's API contains the concept of versioning. Each API release will be create a new version; that is it will have a new endpoint. Versioning is intended to allow us to make changes to the WSDL that may not be backwards compatible. This will allow us to better deliver new functionality as well as make improvements to existing functionality. Be aware that due to WSDL changes future releases might potentially change the way the API is used.
Each version will have its own endpoint and documentation on the forum. Please see the Previous Versions link on the left for older versions of the API.
Hoover’s will support 3 versions on Production and 3 on Development - the versions will be staggered forward on Development after the third released version - e.g. Production versions supported will be 3,2,1 while Development versions supported will be 4,3,2.
Support will no longer be available for retired versions. We will support each version for a minimum of six months. Future forum posts should include the version number you are using for better support.
2. Authentication
2.1 Overview
Every user is provided with an API Key that will be used as part of each request to the Hoover's service.
3. Hoover's API Support
All Support Questions should be posted to the forum. Please indicate if you are using the Development or Production environment and the version. All questions and issues will be answered as quickly as possible. After hours posts will be handled the next business day. If you call Hoover's, you will be directed to the forum.
If you have an urgent Production issue, you can email the address provided to you as part of your Production contract.
4. Queries - Company Information
4.1 Find Company By Keyword Search
4.1.1 Overview
Returns a set of companies based on keyword, along with basic identifying data for each company.
4.1.2 Input Parameters
| Field Name |
Required |
Value |
Notes |
| keyword |
Yes |
String containing a keyword or phrase |
|
| maxRecords |
No |
Between 1-200. Default = 20 |
|
| hitOffset |
No |
Greater than or equal to 1 but less than or equal to 10,000. Default = 1 |
Paging support, first record returned will be hitOffset |
| searchBy |
No |
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 |
No |
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 |
No |
Values defined in WSDL: sortDirectionTypes - Ascending or Descending |
This has no effect without a valid orderBy. |
| returnSearchNavigation |
No |
'true' or 'false' |
If true navigators will be returned in the response to enable drill down into search results |
| searchNavigation/ employeeSearchNavigation/ employeeSearchNavigationValue |
No |
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 |
No |
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 |
No |
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 |
No |
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 |
No |
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 |
No |
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. |
4.1.3 Sample XML Request
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:web="http://webservice.hoovers.com">
<soapenv:Header>
<web:API-KEY>YOUR-API-KEY</web:API-KEY>
</soapenv:Header>
<soapenv:Body>
<web:FindCompanyByKeywordRequest>
<web:keyword>Hoovers</web:keyword>
<web:maxRecords>100</web:maxRecords>
<web:hitOffset>10</web:hitOffset>
<web:searchBy>companyName</web:searchBy>
<web:orderBy>CityName</web:orderBy>
<web:sortDirection>Ascending</web:sortDirection>
<web:returnSearchNavigation>true</web:returnSearchNavigation>
<web:searchNavigation>
<web:employeeSearchNavigation>
<web:employeeSearchNavigationValue>[;4]</web:employeeSearchNavigationValue>
</web:employeeSearchNavigation>
<web:locationTypeSearchNavigation>
<web:locationTypeSearchNavigationValue>0</web:locationTypeSearchNavigationValue>
</web:locationTypeSearchNavigation>
<web:salesSearchNavigation>
<web:salesSearchNavigationValue>[;1></web:salesSearchNavigationValue>
</web:salesSearchNavigation>
<web:locationSearchNavigation>
<web:countryNavigation>
<web:countryNavigationValue>United States</web:countryNavigationValue>
<web:stateNavigation>
<web:stateNavigationValue>^PA$</web:stateNavigationValue>
</web:stateNavigation>
</web:countryNavigation>
</web:locationSearchNavigation>
</web:searchNavigation>
</web:FindCompanyByKeywordRequest>
</soapenv:Body>
</soapenv:Envelope>
4.1.4 Output Parameters
| Field Name |
Value |
Notes |
| return/navigators |
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\resultSet\first-hit |
First Hit |
|
| \return\resultSet\hit\company-results\locationType |
Location type such as Headquarters or branch |
|
| \return\resultSet\hit\company-results\addrcity |
Address City |
|
| \return\resultSet\hit\company-results\addrcountry |
Address Country |
|
| \return\resultSet\hit\company-results\addrcountryid |
Address Country ID |
|
| \return\resultSet\hit\company-results\addrstateprov |
Address State/Province |
ID Value from GetAdvancedSearchLookups |
| \return\resultSet\hit\company-results\companyid |
Hoovers Company ID |
|
| \return\resultSet\hit\company-results\duns |
DUNS Number |
|
| \return\resultSet\hit\company-results\parent-duns |
Parent Company DUNS Number |
|
| \return\resultSet\hit\company-results\ultimate-parent-duns |
Ultimate Parent Company DUNS Number |
|
| \return\resultSet\hit\company-results\finsales |
Annual Sales |
|
| \return\resultSet\hit\company-results\recname |
Company Name |
|
| \return\companies\hit\companyresults\hqphone |
Headquarters Phone Number |
|
| \return\resultSet\hit\number |
Hit Number |
|
| \return\resultSet\hits |
Total Number of Hits in this Response |
|
| \return\resultSet\last-hit |
Last Hit |
|
| \return\resultSet\total-hits |
Aggregate Total Number of Hits |
This is the total number of results the search returned |
4.1.5 Sample XML Response
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Body>
<web:FindCompanyByKeywordResponse xmlns:web="http://webservice.hoovers.com">
<web:return>
<web:navigators>
<web:employeeNavigators>
<web:employeeNavigator>
<web:employeeNavigatorValue>[;4]</web:employeeNavigatorValue>
<web:employeeNavigatorDescription>1-4 (3)</web:employeeNavigatorDescription>
</web:employeeNavigator>
...
</web:employeeNavigators>
<web:locationTypeNavigators>
<web:locationTypeNavigator>
<web:locationTypeNavigatorValue>2</web:locationTypeNavigatorValue>
<web:locationTypeNavigatorDescription>Branch (5)</web:locationTypeNavigatorDescription>
</web:locationTypeNavigator>
...
</web:locationTypeNavigators>
<web:companyTypeNavigators>
<web:companyTypeNavigator>
<web:companyTypeNavigatorValue>2</web:companyTypeNavigatorValue>
<web:companyTypeNavigatorDescription>Private (23)</web:companyTypeNavigatorDescription>
</web:companyTypeNavigator>
...
</web:companyTypeNavigators>
<web:salesNavigators>
<web:salesNavigator>
<web:salesNavigatorValue>[;1></web:salesNavigatorValue>
<web:salesNavigatorDescription>< $1 million (24)</web:salesNavigatorDescription>
</web:salesNavigator>
...
</web:salesNavigators>
<web:locationNavigators>
<web:countryNavigators>
<web:countryNavigator>
<web:countryNavigatorValue>United States</web:countryNavigatorValue>
<web:countryNavigatorDescription>United States (49)</web:countryNavigatorDescription>
<web:stateProvinceNavigators>
<web:stateProvinceNavigator>
<web:stateProvinceNavigatorValue>^CA$</web:stateProvinceNavigatorValue>
<web:stateProvinceNavigatorDescription>CA (49)</web:stateProvinceNavigatorDescription>
</web:stateProvinceNavigator>
</web:stateProvinceNavigators>
</web:countryNavigator>
</web:countryNavigators>
</web:locationNavigators>
</web:navigators>
<web:resultSet>
<web:first-hit>1</web:first-hit>
<web:hit>
<web:company-results>
<web:locationType>Headquarters</web:locationType>
<web:addrcity>Austin</web:addrcity>
<web:addrcountry>United States</web:addrcountry>
<web:addrcountryid>76</web:addrcountryid>
<web:addrstateprov>TX</web:addrstateprov>
<web:company-id>41416611241688</web:company-id>
<web:duns>611241688</web:duns>
<web:parent-duns>884114609</web:parent-duns>
<web:ultimate-parent-duns>884114609</web:ultimate-parent-duns>
<web:finsales>107.5</web:finsales>
<web:recname>Hoover's, Inc.</web:recname>
<web:hqphone>512-374-4500</web:hqphone>
</web:company-results>
<web:number>1</web:number>
</web:hit>
...
<web:hits>20</web:hits>
<web:last-hit>20</web:last-hit>
<web:total-hits>567</web:total-hits>
</web:resultSet>
</web:return>
</web:FindCompanyByKeywordResponse>
</soapenv:Body>
</soapenv:Envelope>
4.2 Get Company Detail
4.2.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.
4.2.2 Input Parameters
| Field Name |
Required |
Value |
Notes |
| uniqueId |
Yes |
Hoovers Company ID -OR- DUNS Number |
See note above |
4.2.3 Sample XML Request
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:web="http://webservice.hoovers.com">
<soapenv:Header>
<web:API-KEY>YOUR-API-KEY</web:API-KEY>
</soapenv:Header>
<soapenv:Body>
<web:GetCompanyDetailRequest>
<web:uniqueId>114315195</web:uniqueId>
</web:GetCompanyDetailRequest>
</soapenv:Body>
</soapenv:Envelope>
4.2.4 Output Parameters
| Field Name |
Value |
Notes |
| \return\duns |
Duns number of this company. |
|
| \return\dnbGlobalLinkage\immediateParent |
Hoover's ID of the company's immediate parent |
|
| \return\dnbGlobalLinkage\immediateParentName |
Company name of this company's immediate parent. |
|
| \return\name |
Company Name |
|
| \return\dba |
Doing Business As |
|
| \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\industries\hicName |
HIC Name |
|
| \return\industries\nAICS |
NAICS Code |
|
| \return\industries\sIAC |
US SIC Code |
|
| \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 |
Is Subsidiary? |
|
| \return\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\keyNumbers\sales |
Annual Sales |
This value is in US Dollars. |
| \return\keyNumbers\employeesAtThisLocation |
Employees at this Location |
|
| \return\keyNumbers\totalEmployeeGrowthPercent |
Total Employee Growth % for the Year |
|
| \return\keyNumbers\researchAndDevelopment |
R&D Expenses for the Year |
This value is in US Dollars. |
| \return\keyNumbers\advertising |
Advertising Expenses for the Year |
This value is in US Dollars. |
| \return\keyNumbers\employeesTotal |
Total Employees |
|
| \return\keyNumbers\record-type |
Sales Record Type |
Q = quarter, A = annual |
| \return\keyNumbers\fiscal-period |
Fiscal Period |
|
| \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\phones |
Company Phone Numbers |
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\phones\areaCode |
Phone Number Area Code |
|
| \return\phones\countryCode |
Address Country ID |
|
| \return\phones\phoneNumber |
Phone Number |
|
| \return\stateOfIncorporation |
State of Incorporation |
|
| \return\ownershipYear |
Ownership Year |
|
| \return\synopsis |
Company Description |
|
| \return\familyTreeLink |
Corporate Family Tree Link |
|
| \return\faxNumber |
Company Fax Number |
|
| \return\urls |
Company Urls |
|
| \return\full-description |
Full Company Description |
|
| \return\top-executives |
Top 3 Company Executives |
See GetPersonDetail for further information |
| \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\accountingFirm |
The accounting firm/auditor for this company. |
|
| \return\bankName |
The bank name 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\ukSpecs\numberOfSubsidiaries\foreign |
Number of subsidiaries outside the UK |
|
4.2.5 Sample XML Response
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Body>
<web:GetCompanyDetailResponse xmlns:web="http://webservice.hoovers.com">
<web:return>
<web:duns>611241688</web:duns>
<web:dnbGlobalLinkage>
<web:immediateParent>41416611241688</web:immediateParent>
<web:immediateParentName>The Dun & Bradstreet Corporation</web:immediateParentName>
</web:dnbGlobalLinkage>
<web:name>Hoover's, Inc.</web:name>
<web:industries>
<web:hicName xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<web:nAICS>2731</web:nAICS>
<web:sIAC>511130</web:sIAC>
<web:primaryUKSIC>72.60</web:primaryUKSIC>
<web:allUKSIC>
<web:item>
<web:uksic>72.60</web:uksic>
<web:description>Other computer related activities</web:description>
</web:item>
<web:item>
<web:uksic>22.22</web:uksic>
<web:description>Printing not elsewhere classified</web:description>
</web:item>
...
</web:allUKSIC>
</web:industries>
<web:keyNumbers>
<web:sales>0.194444</web:sales>
<web:employeesTotal>380.0</web:employeesTotal>
</web:keyNumbers>
...
<web:locations>
<web:address1>5800 Airport Blvd.</web:address1>
<web:address2/>
<web:city>Austin</web:city>
<web:country>76</web:country>
<web:state>TX</web:state>
<web:zip>78752</web:zip>
<web:zip4>3812</web:zip4>
</web:locations>
...
<web:ownershipYear>2003</web:ownershipYear>
<web:phones>
<web:countryCode/>
<web:areaCode>512</web:areaCode>
<web:phoneNumber>374-4500</web:phoneNumber>
</web:phones>
...
<web:stateOfIncorporation>DE</web:stateOfIncorporation>
<web:synopsis>If you're reading this sentence, you know where to go for company data. Hoover's, the publisher of this profile, offers proprietary business information through the Internet, data feeds, wireless devices, and co-branding agreements with other online services. Its Web site, Hoover's Online, features a database of information on more than 25 million corporations and organizations. Offering both free and for-pay content, the firm focuses on selling subscriptions (the majority of its revenues) to marketing, sales, and business development professionals. Hoover's also publishes its information in reference books. The company is a subsidiary of <Company ID="10483">Dun & Bradstreet</Company>.</web:synopsis>
<web:stocks>
<web:tickerUS xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<web:exchangeInfoList>
<web:exchangeInfo>
<web:country xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<web:tickerSymbol xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<web:exchangeName xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
</web:exchangeInfo>
...
</web:exchangeInfoList>
</web:stocks>
<web:top-executives>
<web:official>
<web:company-id>41416611241688</web:company-id>
<web:co-official-id>1443072630</web:co-official-id>
<web:latest-position>
<web:title>President</web:title>
<web:start-year>2008</web:start-year>
<web:end-year>Present</web:end-year>
</web:latest-position>
<web:latest-salary>
<web:year>2002</web:year>
<web:salary>191000</web:salary>
<web:total-salary>213000</web:total-salary>
</web:latest-salary>
<web:person>
<web:age>43</web:age>
<web:first-name>Joseph</web:first-name>
<web:full-name/>
<web:last-name>Duhon</web:last-name>
<web:prefix>Mr</web:prefix>
<web:suffix/>
</web:person>
</web:official>
...
</web:top-executives>
<web:familyTreeLink>http://phpqapaid.hoovers.com/subscribe/co/familytree.xhtml?HD=611241688&GD=</web:familyTreeLink>
<web:faxNumber>
<web:countryCode/>
<web:areaCode>123</web:areaCode>
<web:phoneNumber>4567890</web:phoneNumber>
</web:faxNumber>
<web:primaryURL>http://www.acme.com</web:primaryURL>
<web:otherURLs>
<web:url>http://www.acme.com/web/about/ac49/ac20/_annual_reports.html</web:url>
...
</web:otherURLs>
<web:accountingFirm>Ernst & Young Llp San Jose C</web:accountingFirm>
<web:bankName>JP Morgan Chase<web:bankName>
<web:keyFinancials>
<web:marketValueInfo>
<web:marketValue>136605.7188</web:marketValue>
<web:marketValueDate>2008-05-20 00:00:00</web:marketValueDate>
</web:marketValueInfo>
<web:incomeAssets>
<web:period>FY2007</web:period>
<web:assets>0.0</web:assets>
<web:salesGrowthPercent>0.564745</web:salesGrowthPercent>
<web:netIncome>4203.72021484375</web:netIncome>
<web:netIncomeGrowthPercent>0.365975</web:netIncomeGrowthPercent>
</web:incomeAssets>
</web:keyFinancials>
<web:ukSpecs>
<web:uKRegistration/>
<web:uKVAT>545372831</web:uKVAT>
<web:numberOfSubsidiaries>
<web:domestic>3</web:domestic>
<web:foreign>0</web:foreign>
</web:numberOfSubsidiaries>
</web:ukSpecs>
</web:return>
</web:GetCompanyDetailResponse>
</soapenv:Body>
</soapenv:Envelope>
4.3 Advanced Company Search
4.3.1 Overview
Returns search result of companies based on various different criteria
4.3.2 Input Parameters
| Field Name |
Required |
Value |
Notes |
| \bal\companysize\employeesfrom |
No |
Total Employees Lower Bound |
|
| \bal\companysize\employeesgrowthfrom |
No |
Total Employees Growth Percentage Lower Bound |
This field is a double type. |
| \bal\companysize\employeesgrowthto |
No |
Total Employees Growth Percentage Upper Bound |
This field is a double type. |
| \bal\companysize\employeesthislocationfrom |
No |
Employees at this Location Lower Bound |
|
| \bal\companysize\employeesthislocationto |
No |
Employees at this Location Upper Bound |
|
| \bal\companysize\employeesto |
No |
Total Employees Upper Bound |
|
| \bal\companysize\marketcapfrom |
No |
Market Cap ($ mil) Lower Bound |
This field is a double type. |
| \bal\companysize\marketcapto |
No |
Market Cap ($ mil) Upper Bound |
This field is a double type. |
| \bal\companysize\salesfrom |
No |
Annual Sales ($ mil) Lower Bound |
This field is a double type. |
| \bal\companysize\salesgrowthfrom |
No |
Annual Sales Growth (%) Lower Bound |
This field is a double type. |
| \bal\companysize\salesgrowthto |
No |
Annual Sales Growth (%) Upper Bound |
This field is a double type. |
| \bal\companysize\salesto |
No |
Annual Sales ($ mil) Upper Bound |
This field is a double type. |
| \bal\companytype\location |
No |
Location Type |
ID Value from GetAdvancedSearchLookups |
| \bal\companytype\publicprivate |
No |
|
ID Value from GetAdvancedSearchLookups |
| \bal\companytype\status |
No |
Subsidiary Status |
Subsidiary or Not a Subsidiary |
| \bal\financialdata\advertisingexpensefrom |
No |
Ad Expense ($ mil) Lower Bound. |
This field is now a double. |
| \bal\financialdata\advertisingexpenseto |
No |
Ad Expense ($ mil) Upper Bound. |
This field is now a double. |
| \bal\financialdata\assetsfrom |
No |
Assets ($ mil) Lower Bound. |
This field is now a double. |
| \bal\financialdata\assetsto |
No |
Assets ($ mil) Upper Bound. |
This field is now a double. |
| \bal\financialdata\filingdatefrom |
No |
Filing Date Lower Bound |
MM/DD/YYYY |
| \bal\financialdata\filingdateto |
No |
Filing Date Upper Bound |
MM/DD/YYYY |
| \bal\financialdata\fiscalyearend |
No |
Fiscal Year End Month |
|
| \bal\financialdata\incomefrom |
No |
Net Income ($ mil) Lower Bound. |
This field is now a double. |
| \bal\financialdata\incomegrowthfrom |
No |
Net Income Growth (%) Lower Bound |
This field is a double type. |
| \bal\financialdata\incomegrowthto |
No |
Net Income Growth (%) Upper Bound |
This field is a double type. |
| \bal\financialdata\incometo |
No |
Net Income ($ mil) Upper Bound |
This field is a double type. |
| \bal\financialdata\offerfrom |
No |
US IPO Data - Offer Amount ($ mil.) Lower Bound |
This field is a double type. |
| \bal\financialdata\offerto |
No |
US IPO Data - Offer Amount ($ mil.) Upper Bound |
This field is a double type. |
| \bal\financialdata\pricerangefrom |
No |
US IPO Data - Price Range ($) Lower Bound |
This field is a double type. |
| \bal\financialdata\pricerangeto |
No |
US IPO Data - Price Range ($) Upper Bound |
This field is a double type. |
| \bal\financialdata\researchexpensefrom |
No |
R&D Expense ($ mil) Lower Bound |
This field is a double type. |
| \bal\financialdata\researchexpenseto |
No |
R&D Expense ($ mil) Upper Bound |
This field is a double type. |
| \bal\financialdata\tradingdatefrom |
No |
Trading Date Lower Bound |
MM/DD/YYYY |
| \bal\financialdata\tradingdateto |
No |
Trading Date Upper Bound |
MM/DD/YYYY |
| \bal\financialdata\underwriters |
No |
Underwriters |
ID Value from GetAdvancedSearchLookups |
| \bal\industry\hooversindustryname |
No |
Hoovers Industry Name |
ID Value from GetAdvancedSearchLookups |
| \bal\industry\primaryonly |
No |
Primary Industry Only |
Boolean |
| \bal\industry\naics |
No |
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\siac |
No |
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\location\areacode |
No |
US/Canada Area Code |
e.g. 512 or 210, 512, 212 |
| \bal\location\city |
No |
City |
e.g. Madrid or New York (single city only) |
| \bal\location\country |
No |
Country |
ID Value from GetAdvancedSearchLookups |
| \bal\location\globalstate |
No |
Global State/Province |
e.g Queensland or NY (single province/state only) |
| \bal\location\metropolitan |
No |
US Metropolitan Area |
ID Value from GetAdvancedSearchLookups |
| \bal\location\region |
No |
World Region |
ID Value from GetAdvancedSearchLookups |
| \bal\location\state |
No |
US State/Canada Province |
|
| \bal\location\zip |
No |
Zip Code |
e.g. 78701 or "SW1P 1JA" or "SW1" or US ZIP code range 78701-78752. Separate multiple ZIP codes by commas. |
| \bal\location\zipareascale |
No (requires zipareawithin and zipareazipcode) |
Units to search in. (Miles 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. |
| \bal\location\zipareawithin |
No (requires zipareascale and zipareazipcode) |
# of miles or kilometers to search within. (50 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. |
| \bal\location\zipareazipcode |
No (requires zipareascale and zipareawithin) |
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. |
| \bal\location\allany |
No |
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 |
No |
UK County |
ID Value from GetAdvancedSearchLookups |
| \bal\maxrecords |
No |
Max Records |
Between 1-200. Default = 20 |
| \bal\orderby |
No |
Order By |
Values defined in WSDL, orderByTypes |
| \bal\sortdirection |
No |
Sort Direction |
Values defined in WSDL: sortDirectionTypes - Ascending or Descending |
| \bal\specialtycriteria\auditors |
No |
Auditors |
ID Value from GetAdvancedSearchLookups |
| \bal\specialtycriteria\companykeyword |
No |
Company Keyword |
e.g. laptops or China or acquired, merged, takeover |
| \bal\specialtycriteria\duns |
No |
DUNS Number |
|
| \bal\specialtycriteria\exchange |
No |
Exchange |
ID Value from GetAdvancedSearchLookups |
| \bal\specialtycriteria\ranking |
No |
Rankings/Indices |
ID Value from GetAdvancedSearchLookups |
| \bal\specialtycriteria\ukregistration |
No |
UK Registration Number |
e.g. 3443456 or 3443456, 0764797 |
| \bal\specialtycriteria\ukvat |
No |
UK Vat Number |
e.g. 906565610 or 906565610, 466264724 |
| \bal\specialtycriteria\yearfoundingfrom |
No |
Year of Founding or Change in Control Lower Bound |
YYYY |
| \bal\specialtycriteria\yearfoundingto |
No |
Year of Founding or Change in Control (YYYY) Upper Bound |
YYYY |
| \bal\specialtycriteria\ultimateParentDUNS |
No |
The ultimate parent DUNS number for a family of companies |
eg. 060902413 or 884364530 |
| \bal\hitOffset |
No |
Greater than or equal to 1 but less than or equal to 10,000. Default = 1 |
Paging support, first record returned will be hitOffset |
4.3.3 Sample XML Request
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:web="http://webservice.hoovers.com">
<soapenv:Header>
<web:API-KEY>YOUR-API-KEY</web:API-KEY>
</soapenv:Header>
<soapenv:Body>
<web:AdvancedCompanySearchRequest>
<web:bal>
<web:companysize>
<web:employeesFrom>1</web:employeesFrom>
<web:employeesGrowthFrom>2000</web:employeesGrowthFrom>
<web:employeesGrowthTo></web:employeesGrowthTo>
<web:employeesThisLocationFrom></web:employeesThisLocationFrom>
<web:employeesThisLocationTo></web:employeesThisLocationTo>
<web:employeesTo></web:employeesTo>
<web:marketCapFrom></web:marketCapFrom>
<web:marketCapTo></web:marketCapTo>
<web:salesFrom></web:salesFrom>
<web:salesGrowthFrom></web:salesGrowthFrom>
<web:salesGrowthTo></web:salesGrowthTo>
<web:salesTo></web:salesTo>
</web:companysize>
<web:companytype>
<web:location></web:location>
<web:publicPrivate></web:publicPrivate>
<web:status></web:status>
</web:companytype>
<web:financialdata>
<web:advertisingExpenseFrom></web:advertisingExpenseFrom>
<web:advertisingExpenseTo></web:advertisingExpenseTo>
<web:assetsFrom></web:assetsFrom>
<web:assetsTo></web:assetsTo>
<web:filingDateFrom></web:filingDateFrom>
<web:filingDateTo></web:filingDateTo>
<web:fiscalYearEnd></web:fiscalYearEnd>
<web:incomeFrom></web:incomeFrom>
<web:incomeGrowthFrom></web:incomeGrowthFrom>
<web:incomeGrowthTo></web:incomeGrowthTo>
<web:incomeTo></web:incomeTo>
<web:offerFrom></web:offerFrom>
<web:offerTo></web:offerTo>
<web:priceRangeFrom></web:priceRangeFrom>
<web:priceRangeTo></web:priceRangeTo>
<web:researchExpenseFrom></web:researchExpenseFrom>
<web:researchExpenseTo></web:researchExpenseTo>
<web:tradingDateFrom></web:tradingDateFrom>
<web:tradingDateTo></web:tradingDateTo>
<web:underwriters></web:underwriters>
</web:financialdata>
<web:industry>
<web:hooversIndustryName></web:hooversIndustryName>
<web:primaryOnly></web:primaryOnly>
<web:nAICS></web:nAICS>
<web:sIAC></web:sIAC>
</web:industry>
<web:location>
<web:areaCode>512</web:areaCode>
<web:city></web:city>
<web:country></web:country>
<web:globalState></web:globalState>
<web:metropolitan></web:metropolitan>
<web:region></web:region>
<web:state></web:state>
<web:zip></web:zip>
<web:zipAreaScale></web:zipAreaScale>
<web:zipAreaWithin></web:zipAreaWithin>
<web:zipAreaZipCode></web:zipAreaZipCode>
<web:allAny></web:allAny>
<web:ukCounty></web:ukCounty>
</web:location>
<web:maxRecords>20</web:maxRecords>
<web:orderBy></web:orderBy>
<web:sortDirection></web:sortDirection>
<web:specialtyCriteria>
<web:auditors></web:auditors>
<web:companyKeyword></web:companyKeyword>
<web:duns></web:duns>
<web:exchange></web:exchange>
<web:ranking></web:ranking>
<web:uKRegistration></web:uKRegistration>
<web:uKVAT></web:uKVAT>
<web:yearFoundingFrom></web:yearFoundingFrom>
<web:yearFoundingTo></web:yearFoundingTo>
</web:specialtyCriteria>
<web:hitOffset>300</web:hitOffset>
</web:bal>
</web:AdvancedCompanySearchRequest>
</soapenv:Body>
</soapenv:Envelope>
4.3.4 Output Parameters
| Field Name |
Value |
Notes |
| \return\companies\firsthit |
First Hit |
|
| \return\companies\hit\companyresults\locationType |
Location Type such as head quarters or branch |
|
| \return\companies\hit\companyresults\addrcity |
Address City |
|
| \return\companies\hit\companyresults\addrcountry |
Address Country |
|
| \return\companies\hit\companyresults\addrcountryid |
Address Country ID |
|
| \return\companies\hit\companyresults\addrstateprov |
Address State/Province |
|
| \return\companies\hit\companyresults\companyid |
Hoovers Company ID |
|
| \return\companies\hit\companyresults\duns |
DUNS Number |
|
| \return\resultSet\hit\company-results\parent-duns |
Parent Company DUNS Number |
|
| \return\resultSet\hit\company-results\ultimate-parent-duns |
Ultimate Parent Company DUNS Number |
|
| \return\companies\hit\companyresults\finsales |
Annual Sales |
|
| \return\companies\hit\companyresults\recname |
Company Name |
|
| \return\companies\hit\companyresults\hqphone |
Headquarters Phone Number |
|
| \return\companies\hit\number |
Hit Number |
|
| \return\companies\hits |
Total Number of Hits in this Response |
|
| \return\companies\lasthit |
Last Hit |
|
| \return\companies\total-hits |
Aggregate Total Number of Hits |
This is the total number of results the search returned |
4.3.5 Sample XML Response
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Body>
<web:AdvancedCompanySearchResponse xmlns:web="http://webservice.hoovers.com">
<web:return>
<web:companies>
<web:first-hit>1</web:first-hit>
<web:hit>
<web:company-results>
<web:locationType>Headquarters</web:locationType>
<web:addrcity>Austin</web:addrcity>
<web:addrcountry>United States</web:addrcountry>
<web:addrcountryid>76</web:addrcountryid>
<web:addrstateprov>TX</web:addrstateprov>
<web:company-id>947855136</web:company-id>
<web:duns>947855136</web:duns>
<web:parent-duns>884114609</web:parent-duns>
<web:ultimate-parent-duns>884114609</web:ultimate-parent-duns>
<web:finsales>0.649999976158</web:finsales>
<web:recname>Hart's, Steve Bowling Supply</web:recname>
<web:hqphone>512-374-4500</web:hqphone>
</web:company-results>
<web:number>1</web:number>
</web:hit>
...
<web:hits>5</web:hits>
<web:last-hit>5</web:last-hit>
<web:total-hits>567</web:total-hits>
</web:companies>
</web:return>
</web:AdvancedCompanySearchResponse>
</soapenv:Body>
</soapenv:Envelope>
4.4 Get Family Tree
4.4.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.
4.4.2 Input Parameters
| Field Name |
Required |
Value |
Notes |
| uniqueId |
Yes |
Hoovers Company ID -OR- DUNS Number |
|
4.4.3 Sample XML Request
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:web="http://webservice.hoovers.com">
<soapenv:Header>
<web:API-KEY>YOUR-API-KEY</web:API-KEY>
</soapenv:Header>
<soapenv:Body>
<web:GetFamilyTreeRequest>
<web:uniqueId>41416611241688</web:uniqueId>
</web:GetFamilyTreeRequest>
</soapenv:Body>
</soapenv:Envelope>
4.4.4 Output Parameters
| Field Name |
Value |
Notes |
| \return\name |
Company Name |
|
| \return\company-id |
Hoovers Company ID |
|
| \return\duns |
DUNS Number |
|
| \return\parent-duns |
Parent Company DUNS Number |
|
| \return\ultimate-parent-duns |
Ultimate Parent Company DUNS Number |
|
| \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\company-id |
Child Hoovers Company ID |
|
| \return\children\child\duns |
Child DUNS Number |
|
| \return\children\child\parent-duns |
Child Parent Company DUNS Number |
|
| \return\children\child\ultimate-parent-duns |
Child Ultimate Parent Company DUNS Number |
|
| \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. |
4.4.5 Sample XML Response
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Body>
<web:GetFamilyTreeResponse xmlns:web="http://webservice.hoovers.com">
<web:return>
<web:name>Acme Inc.</web:name>
<web:company-id>1319311431534</web:company-id>
<web:duns>11431534</web:duns>
<web:parent-duns/>
<web:ultimate-parent-duns/>
<web:revenue>611.0</web:revenue>
<web:location-type>Headquarters</web:location-type>
<web:city>Austin</web:city>
<web:state>TX</web:state>
<web:country>United States</web:country>
<web:total-children>327</web:total-children>
<web:children>
<web:child>
<web:number>1</web:number>
<web:name>Acme Inc</web:name>
<web:company-id>662076933</web:company-id>
<web:duns>662076933</web:duns>
<web:parent-duns>11431534</web:parent-duns>
<web:ultimate-parent-duns>11431534</web:ultimate-parent-duns>
<web:revenue>0.0</web:revenue>
<web:location-type>Branch</web:location-type>
<web:city>Dallas</web:city>
<web:state>TX</web:state>
<web:country>United States</web:country>
</web:child>
<web:child>
<web:number>2</web:number>
<web:name>Acme Inc</web:name>
<web:company-id>1010313833</web:company-id>
<web:duns>1010313833</web:duns>
<web:parent-duns>11431534</web:parent-duns>
<web:ultimate-parent-duns>11431534</web:ultimate-parent-duns>
<web:revenue>0.0</web:revenue>
<web:location-type>Branch</web:location-type>
<web:city>Atlanta</web:city>
<web:state>GA</web:state>
<web:country>United States</web:country>
</web:child>
<web:child>
<web:number>3</web:number>
<web:name>Acme Inc</web:name>
<web:company-id>1155841333</web:company-id>
<web:duns>1155841333</web:duns>
<web:parent-duns>11431534</web:parent-duns>
<web:ultimate-parent-duns>11431534</web:ultimate-parent-duns>
<web:revenue>0.0</web:revenue>
<web:location-type>Branch</web:location-type>
<web:city>Nashville</web:city>
<web:state>TN</web:state>
<web:country>United States</web:country>
</web:child>
<web:child>
<web:number>4</web:number>
<web:name>Acme Corporation</web:name>
<web:company-id>2553309233</web:company-id>
<web:duns>2553309233</web:duns>
<web:parent-duns>11431534</web:parent-duns>
<web:ultimate-parent-duns>11431534</web:ultimate-parent-duns>
<web:revenue>0.939</web:revenue>
<web:location-type>Headquarters/Subsidiary</web:location-type>
<web:city>Skokie</web:city>
<web:state>IL</web:state>
<web:country>United States</web:country>
<web:children>
<web:child>
<web:number>5</web:number>
<web:name>Acme Corporation</web:name>
<web:company-id>11454490133</web:company-id>
<web:duns>11454490133</web:duns>
<web:parent-duns>02553334</web:parent-duns>
<web:ultimate-parent-duns>11431534</web:ultimate-parent-duns>
<web:revenue>0.0</web:revenue>
<web:location-type>Branch</web:location-type>
<web:city>Saint Charles</web:city>
<web:state>IL</web:state>
<web:country>United States</web:country>
</web:child>
.
.
.
</web:children>
</web:child>
.
.
.
</web:children>
</web:return>
</web:GetFamilyTreeResponse>
</soapenv:Body>
</soapenv:Envelope>
4.5 Find Competitors By Company ID
4.5.1 Overview
Returns all competitors for a given Hoover's Company ID or DUNS
4.5.2 Input Parameters
| Field Name |
Required |
Value |
Notes |
| uniqueId |
Yes |
Hoovers Company ID -OR- DUNS Number |
|
4.5.3 Sample XML Request
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:web="http://webservice.hoovers.com">
<soapenv:Header>
<web:API-KEY>YOUR-API-KEY</web:API-KEY>
</soapenv:Header>
<soapenv:Body>
<web:FindCompetitorsByCompanyIDRequest>
<web:uniqueId>41416611241688</web:uniqueId>
</web:FindCompetitorsByCompanyIDRequest>
</soapenv:Body>
</soapenv:Envelope>
4.5.4 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\parent-duns |
Parent Company DUNS Number |
|
| \return\competitor\ultimate-parent-duns |
Ultimate Parent Company DUNS Number |
|
| \return\competitor\finsales |
Annual Sales |
|
| \return\competitor\companyid |
Hoovers Company ID |
|
4.5.5 Sample XML Response
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Body>
<web:FindCompetitorsByCompanyIDResponse xmlns:web="http://webservice.hoovers.com">
<web:return>
<web:competitor>
<web:addrcity>Tualatin</web:addrcity>
<web:addrcountry>United States</web:addrcountry>
<web:addrcountryid>76</web:addrcountryid>
<web:addrstateprov>OR</web:addrstateprov>
<web:company-id>123456789</web:company-id>
<web:duns>123456789</web:duns>
<web:parent-duns/>
<web:ultimate-parent-duns/>
<web:finsales>105.0</web:finsales>
<w>Hooverworks, Inc.</web:recname>
<web:topcompetitor>false</web:topcompetitor>
</web:competitor>
<web:competitor>
<web:addrcity>Tokyo</web:addrcity>
<web:addrcountry>Japan</web:addrcountry>
<web:addrcountryid>43</web:addrcountryid>
<web:addrstateprov/>
<web:company-id>987654321</web:company-id>
<web:duns>987654321</web:duns>
<web:parent-duns/>
<web:ultimate-parent-duns/>
<web:finsales>8960</web:finsales>
<web:recname>Sample Corporation</web:recname>
<web:topcompetitor>true</web:topcompetitor>
</web:competitor>
.
.
.
<web:competitor>
<web:addrcity>Hsin-Tien</web:addrcity>
<web:addrcountry>Taiwan</web:addrcountry>
<web:addrcountryid>70</web:addrcountryid>
<web:addrstateprov>Taipei</web:addrstateprov>
<web:company-id>888888888</web:company-id>
<web:duns>888888888</web:duns>
<web:parent-duns/>
<web:ultimate-parent-duns/>
<web:finsales>0.0</web:finsales>
<web:recname>Hoov Technologies, Inc.</web:recname>
<web:topcompetitor>false</web:topcompetitor>
</web:competitor>
</web:return>
</web:FindCompetitorsByCompanyIDResponse>
</soapenv:Body>
</soapenv:Envelope>
4.6 Get Company Detail Simple
4.6.1 Overview
Returns a reduced subset of company details for a given Hoover's Company ID or DUNS
4.6.2 Input Parameters
| Field Name |
Required |
Value |
Notes |
| uniqueId |
Yes |
Hoovers Company ID -OR- DUNS Number |
|
4.6.3 Sample XML Request
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:web="http://webservice.hoovers.com">
<soapenv:Header>
<web:API-KEY>YOUR-API-KEY</web:API-KEY>
</soapenv:Header>
<soapenv:Body>
<web:GetCompanyDetailSimpleRequest>
<web:uniqueId>41416611241688</web:uniqueId>
</web:GetCompanyDetailSimpleRequest>
</soapenv:Body>
</soapenv:Envelope>
4.6.4 Output Parameters
| Field Name |
Value |
Type |
Notes |
| \return\name |
Company Name |
String |
|
| \return\company-id |
Hoovers Company ID |
BigInteger |
|
| \return\locations\address1 |
Company Address1 |
String |
|
| \return\locations\address2 |
Company Address2 |
String |
|
| \return\locations\city |
Company City |
String |
|
| \return\locations\country |
Company Country ID |
String |
|
| \return\locations\state |
Company State |
String |
|
| \return\locations\zip |
Postal code |
String |
|
| \return\locations\zip4 |
Postal code |
String |
|
| \return\phones\countryCode |
Address Country ID |
String |
|
| \return\phones\areaCode |
Phone Number Area Code |
String |
|
| \return\phones\phoneNumber |
Phone Number |
String |
|
| \return\primaryURL |
Primary URL for the company |
String |
|
4.6.5 Sample XML Response
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Body>
<web:GetCompanyDetailSimpleResponse xmlns:web="http://webservice.hoovers.com">
<web:return>
<web:name>Hoovers Inc</web:name>
<web:company-id>123456789</web:company-id>
<web:locations>
<web:address1>123 Main Street</web:address1>
<web:address2>Ste 300</web:address2>
<web:city>Austin</web:city>
<web:country>76</web:country>
<web:state>TX</web:state>
<web:zip>75827</web:zip>
<web:zip4>123</web:zip4>
</web:locations>
<web:phones>
<web:countryCode>1</web:countryCode>
<web:areaCode>502</web:areaCode>
<web:phoneNumber>789-1200</web:phoneNumber>
</web:phones>
<web:primaryURL>http://www.hoovers.com</web:primaryURL>
</web:return>
</web:GetCompanyDetailSimpleResponse>
</soapenv:Body>
</soapenv:Envelope>
4.7 Get Hoovers Links
4.7.1 Overview
Returns premium links to Company information for a given Hoover's Company ID or DUNS
4.7.2 Input Parameters
| Field Name |
Required |
Value |
Notes |
| uniqueId |
Yes |
Hoovers Company ID -OR- DUNS Number |
|
4.7.3 Sample XML Request
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:web="http://webservice.hoovers.com">
<soapenv:Header>
<web:API-KEY>YOUR-API-KEY</web:API-KEY>
</soapenv:Header>
<soapenv:Body>
<web:GetHooversLinksRequest>
<web:uniqueId>41416611241688</web:uniqueId>
</web:GetHooversLinksRequest>
</soapenv:Body>
</soapenv:Envelope>
4.7.4 Output Parameters
| Field Name |
Value |
Type |
Notes |
| \return\premiumLinks\companyFactSheet\url |
Company FactSheet URL |
String |
|
| \return\premiumLinks\companyCompetitiveLandscape\url |
Company Competitive Landscape URL |
String |
|
| \return\premiumLinks\companyFinancials\url |
Company Financials URL |
String |
|
| \return\premiumLinks\companyProductsOperations\url |
Company Products and Operations URL |
String |
|
| \return\premiumLinks\companyOverview\url |
Company Overview URL |
String |
|
| \return\premiumLinks\companyNews\url |
Company News URL |
String |
|
4.7.5 Sample XML Response
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Body>
<web:GetHooversLinksResponse xmlns:web="http://webservice.hoovers.com">
<web:return>
<web:premiumLinks>
<web:companyFactSheet>
<web:url>http://www.hoovers.com/factsheet</web:url>
</web:companyFactSheet>
<web:companyCompetitiveLandscape>
<web:url>http://www.hoovers.com/competitiveLandscape</web:url>
</web:companyCompetitiveLandscape>
<web:companyFinancials>
<web:url>http://www.hoovers.com/financials</web:url>
</web:companyFinancials>
<web:companyProductsOperations>
<web:url>http://www.hoovers.com/productsoperations</web:url>
</web:companyProductsOperations>
<web:companyOverview>
<web:url>http://www.hoovers.com/overview</web:url>
</web:companyOverview>
<web:companyNews>
<web:url>http://www.hoovers.com/news</web:url>
</web:companyNews>
</web:premiumLinks>
</web:return>
</web:GetCompanyDetailSimpleResponse>
</soapenv:Body>
</soapenv:Envelope>
5. Queries - Person Information
5.1 Find Person By Keyword Search
5.1.1 Overview
Returns search result of people based on keyword. The keyword should be a person's name or part of a name.
5.1.2 Input Parameters
| Field Name |
Required |
Value |
Notes |
| keyword |
Yes |
String containing a keyword |
|
| maxRecords |
No |
Between 1-200. Default = 20 |
|
| hitOffset |
No |
Greater than or equal to 1 but less than or equal to 10,000. Default = 1 |
Paging support, first record returned will be hitOffset |
| sortDirection |
No |
Values defined in WSDL: sortDirectionTypes - Ascending or Descending |
This has no effect without a valid orderBy. |
| orderBy |
No |
Values defined in WSDL, orderByTypes |
Relevant values for this search include:
- Person (Sorts by relevance; this is the default. Note that relevance is always sorted Descending.)
- PersonLastName
- PersonTitle
- CompanyName
|
5.1.3 Sample XML Request
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:web="http://webservice.hoovers.com">
<soapenv:Header>
<web:API-KEY>YOUR-API-KEY</web:API-KEY>
</soapenv:Header>
<soapenv:Body>
<web:FindPersonByKeywordRequest>
<web:keyword>exec</web:keyword>
<web:hitOffset>300</web:hitOffset>
<web:sortDirection>Ascending</web:sortDirection>
<web:orderBy>PersonLastName</web:orderBy>
</web:FindPersonByKeywordRequest>
</soapenv:Body>
</soapenv:Envelope>
5.1.4 Output Parameters
| Field Name |
Value |
Notes |
| \return\resultset\firsthit |
First Hit |
|
| \return\resultset\hit\coofficialresults\coofficialid |
Hoovers Officer ID |
|
| \return\resultset\hit\coofficialresults\companyid |
Hoovers Company ID |
|
| \return\resultset\hit\coofficialresults\pnamefirst |
Person First Name |
|
| \return\resultset\hit\coofficialresults\pnamelast |
Person Last Name |
|
| \return\resultset\hit\coofficialresults\pnamemiddle |
Person Middle Name |
|
| \return\resultset\hit\coofficialresults\psuffix |
Person Suffix |
|
| \return\resultset\hit\coofficialresults\ptitle |
Person Title |
|
| \return\resultset\hit\coofficialresults\recname |
Company Name |
|
| \return\resultset\hit\number |
Hit Number |
|
| \return\resultset\hits |
Total Number of Hits in this Response |
|
| \return\resultset\lasthit |
Last Hit |
|
| \return\resultset\total-hits |
Aggregate Total Number of Hits |
This is the total number of results the search returned |
5.1.5 Sample XML Response
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Body>
<web:FindPersonByKeywordResponse xmlns:web="http://webservice.hoovers.com">
<web:return>
<web:resultSet>
<web:first-hit>1</web:first-hit>
<web:hit>
<web:co-official-results>
<web:co-official-id>1443072630</web:co-official-id>
<web:company-id>110929044</web:company-id>
<web:pnamefirst>Joseph</web:pnamefirst>
<web:pnamelast>Duhon</web:pnamelast>
<web:pnamemiddle/>
<web:psuffix/>
<web:ptitle>President</web:ptitle>
<web:recname>Exec Express Inc</web:recname>
</web:co-official-results>
<web:number>1</web:number>
</web:hit>
...
<web:hits>20</web:hits>
<web:last-hit>20</web:last-hit>
<web:total-hits>567</web:total-hits>
</web:resultSet>
</web:return>
</web:FindPersonByKeywordResponse>
</soapenv:Body>
</soapenv:Envelope>
5.2 Get Person Detail
5.2.1 Overview
Returns search result of detailed person information based on criteria of a Hoover's Officer ID.
When calling this service, ensure the Hoover's Officer ID you send is a recent value from the Find Person by Keyword Search. These IDs are not constant and therefore sending an "old" Hoover's Officer ID will cause either invalid or no results.
5.2.2 Input Parameters
| Field Name |
Required |
Value |
Notes |
| uniqueId |
Yes |
Hoovers Officer ID |
|
5.2.3 Sample XML Request
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:web="http://webservice.hoovers.com">
<soapenv:Header>
<web:API-KEY>YOUR-API-KEY</web:API-KEY>
</soapenv:Header>
<soapenv:Body>
<web:GetPersonDetailRequest>
<web:uniqueId>1253484</web:uniqueId>
</web:GetPersonDetailRequest>
</soapenv:Body>
</soapenv:Envelope>
5.2.4 Output Parameters
| Field Name |
Value |
Notes |
| \return\official |
Company Official Wrapper |
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\official\company-id |
Hoovers Company ID |
|
| \return\official\duns |
DUNS number |
|
| \return\official\co-official-id |
Hoovers Officer ID |
|
| \return\official\biography |
Biographic Information |
|
| \return\official\biographySource |
Biography Source Name |
|
| \return\official\latest-position\title |
Person Title |
|
| \return\official\latest-position\start-year |
Latest position start year |
|
| \return\official\latest-position\end-year |
Latest position end year |
|
| \return\official\position-history |
Collection on position elements (position history for the official) |
|
| \return\official\position-history\position\title |
Person Title |
|
| \return\official\position-history\position\start-year |
Position start-year |
|
| \return\official\position-history\position\end-year |
Position end-year |
|
| \return\official\latest-salary\year |
Latest salary year |
|
| \return\official\latest-salary\salary |
Salary for the year, excluding bonus in USD |
|
| \return\official\latest-salary\total-salary |
Total compensation for the year, including any bonus or other compensation in USD |
|
| \return\official\salary-history |
Collection on salary elements (salary history for the official) |
|
| \return\official\salary-history\salary\year |
Salary Year |
|
| \return\official\salary-history\salary\salary |
Salary for the year excluding bonus in USD |
|
| \return\official\salary-history\salary\total-salary |
Total compensation including bonus in USD |
|
| \return\official\person\fullName |
Person Full Name |
|
| \return\official\person\lastName |
Person Last Name |
|
| \return\official\person\firstName |
Person First Name |
|
| \return\official\person\middleName |
Person Middle Name |
|
| \return\official\person\suffix |
Person Suffix |
|
| \return\official\person\prefix |
Person Prefix |
|
| \return\official\person\age |
Person Age |
|
5.2.5 Sample XML Response
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Body>
<web:GetPersonDetailResponse xmlns:web="http://webservice.hoovers.com">
<web:return>
<web:official>
<web:company-id>110929044</web:company-id>
<web:duns>110929044</web:duns>
<web:co-official-id>1443072630</web:co-official-id>
<web:biography>Graduated from college. Achieved much. Best president ever.</web:biography>
<web:biographySource>Company Web Site</web:biographySource>
<web:latest-position>
<web:title>President</web:title>
<web:start-year>2008</web:start-year>
<web:end-year>Present</web:end-year>
</web:latest-position>
<web:position-history>
<web:position>
<web:title>Chairman</web:title>
<web:start-year>2007</web:start-year>
<web:end-year>2008</web:end-year>
</web:position>
<web:position>
<web:title>Chairman</web:title>
<web:start-year>2006</web:start-year>
<web:end-year>2007</web:end-year>
</web:position>
...
</web:position-history>
<web:latest-salary>
<web:year>2008</web:year>
<web:salary>191000</web:salary>
<web:total-salary>213000</web:total-salary>
</web:latest-salary>
<web:salary-history>
<web:salary>
<web:year>2007</web:year>
<web:salary>181000</web:salary>
<web:total-salary>211000</web:total-salary>
</web:salary>
<web:salary>
<web:year>2006</web:year>
<web:salary>161000</web:salary>
<web:total-salary>200000</web:total-salary>
</web:salary>
...
</web:salary-history>
<web:person>
<web:age>0</web:age>
<web:first-name>Joseph</web:first-name>
<web:full-name/>
<web:last-name>Duhon</web:last-name>
<web:prefix>Mr</web:prefix>
<web:suffix/>
</web:person>
</web:official>
</web:return>
</web:GetPersonDetailResponse>
</soapenv:Body>
</soapenv:Envelope>
5.3 Advanced Person Search
5.3.1 Overview
Returns search result of people based on various different criteria
5.3.2 Input Parameters
| Field Name |
Required |
Value |
Notes |
| \bal\companysize\employeesfrom |
No |
Total Employees Lower Bound |
|
| \bal\companysize\employeesgrowthfrom |
No |
Total Employees Growth Percentage Lower Bound |
This field is a double type. |
| \bal\companysize\employeesgrowthto |
No |
Total Employees Growth Percentage Upper Bound |
This field is a double type. |
| \bal\companysize\employeesthislocationfrom |
No |
Employees at this Location Lower Bound |
|
| \bal\companysize\employeesthislocationto |
No |
Employees at this Location Upper Bound |
|
| \bal\companysize\employeesto |
No |
Total Employees Upper Bound |
|
| \bal\companysize\marketcapfrom |
No |
Market Cap ($ mil) Lower Bound |
This field is a double type. |
| \bal\companysize\marketcapto |
No |
Market Cap ($ mil) Upper Bound |
This field is a double type. |
| \bal\companysize\salesfrom |
No |
Annual Sales ($ mil) Lower Bound |
This field is a double type. |
| \bal\companysize\salesgrowthfrom |
No |
Annual Sales Growth (%) Lower Bound |
This field is a double type. |
| \bal\companysize\salesgrowthto |
No |
Annual Sales Growth (%) Upper Bound |
This field is a double type. |
| \bal\companysize\salesto |
No |
Annual Sales ($ mil) Upper Bound |
This field is a double type. |
| \bal\companytype\location |
No |
Location Type |
ID Value from GetAdvancedSearchLookups |
| \bal\companytype\publicprivate |
No |
Public or Private Company |
ID Value from GetAdvancedSearchLookups |
| \bal\companytype\status |
No |
Subsidiary Status |
Subsidiary or Not a Subsidiary |
| \bal\financialdata\advertisingexpensefrom |
No |
Ad Expense ($ mil) Lower Bound |
|
| \bal\financialdata\advertisingexpenseto |
No |
Ad Expense ($ mil) Upper Bound |
|
| \bal\financialdata\assetsfrom |
No |
Assets ($ mil) Lower Bound |
|
| \bal\financialdata\assetsto |
No |
Assets ($ mil) Upper Bound |
|
| \bal\financialdata\filingdatefrom |
No |
Filing Date Lower Bound |
MM/DD/YYYY |
| \bal\financialdata\filingdateto |
No |
Filing Date Upper Bound |
MM/DD/YYYY |
| \bal\financialdata\fiscalyearend |
No |
Fiscal Year End Month |
|
| \bal\financialdata\incomefrom |
No |
Net Income ($ mil) Lower Bound |
|
| \bal\financialdata\incomegrowthfrom |
No |
Net Income Growth (%) Lower Bound |
|
| \bal\financialdata\incomegrowthto |
No |
Net Income Growth (%) Upper Bound |
|
| \bal\financialdata\incometo |
No |
Net Income ($ mil) Upper Bound |
|
| \bal\financialdata\offerfrom |
No |
US IPO Data - Offer Amount ($ mil.) Lower Bound |
|
| \bal\financialdata\offerto |
No |
US IPO Data - Offer Amount ($ mil.) Upper Bound |
|
| \bal\financialdata\pricerangefrom |
No |
US IPO Data - Price Range ($) Lower Bound |
|
| \bal\financialdata\pricerangeto |
No |
US IPO Data - Price Range ($) Upper Bound |
|
| \bal\financialdata\researchexpensefrom |
No |
R&D Expense ($ mil) Lower Bound |
|
| \bal\financialdata\researchexpenseto |
No |
R&D Expense ($ mil) Upper Bound |
|
| \bal\financialdata\tradingdatefrom |
No |
Trading Date Lower Bound |
MM/DD/YYYY |
| \bal\financialdata\tradingdateto |
No |
Trading Date Upper Bound |
MM/DD/YYYY |
| \bal\financialdata\underwriters |
No |
Underwriters |
ID Value from GetAdvancedSearchLookups |
| \bal\industry\hooversindustryname |
No |
Hoovers Industry Name |
ID Value from GetAdvancedSearchLookups |
| \bal\industry\primaryonly |
No |
Primary Industry Only |
Boolean |
| \bal\industry\naics |
No |
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\siac |
No |
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\location\areacode |
No |
US/Canada Area Code |
e.g. 512 or 210, 512, 212 |
| \bal\location\city |
No |
City |
e.g. Madrid or New York (single city only) |
| \bal\location\country |
No |
Country |
ID Value from GetAdvancedSearchLookups |
| \bal\location\globalstate |
No |
Global State/Province |
e.g Queensland or NY (single province/state only) |
| \bal\location\metropolitan |
No |
US Metropolitan Area |
ID Value from GetAdvancedSearchLookups |
| \bal\location\region |
No |
World Region |
ID Value from GetAdvancedSearchLookups |
| \bal\location\state |
No |
US State/Canada Province |
ID Value from GetAdvancedSearchLookups |
| \bal\location\zip |
No |
Zip Code |
e.g. 78701 or "SW1P 1JA" or "SW1" or US ZIP code range 78701-78752. Separate multiple ZIP codes by commas. |
| \bal\location\zipareascale |
No |
Units to search in. (Miles 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. |
| \bal\location\zipareawithin |
No |
# of miles or kilometers to search within. (50 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. |
| \bal\location\zipareazipcode |
No |
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. |
| \bal\location\allany |
No |
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 |
No |
UK County |
ID Value from GetAdvancedSearchLookups |
| \bal\maxrecords |
No |
Max Records |
Between 1-200. Default = 20 |
| \bal\orderby |
No |
Order By |
Values defined in WSDL, orderByTypes |
| \bal\people\agefrom |
No |
Person Age Lower Bound |
|
| \bal\people\ageto |
No |
Person Age Upper Bound |
|
| \bal\people\bonusfrom |
No |
Person Bonus ($) Lower Bound |
|
| \bal\people\bonusto |
No |
Person Bonus ($) Upper Bound |
|
| \bal\people\jobfunction |
No |
Person Job Function |
ID Value from GetAdvancedSearchLookups |
| \bal\people\keywordsin |
No |
Keywords In |
Title, Bio, or Both |
| \bal\people\keywordselect |
No |
Person Keyword |
e.g. marketing or Harvard or ad sales |
| \bal\people\salaryfrom |
No |
Person Salary ($) Lower Bound |
|
| \bal\people\salaryto |
No |
Person Salary ($) Upper Bound |
|
| \bal\people\totalpayfrom |
No |
Person Total Pay ($) Lower Bound |
|
| \bal\people\totalpayto |
No |
Person Total Pay ($) Upper Bound |
|
| \bal\sortdirection |
No |
Sort Direction |
Values defined in WSDL: sortDirectionTypes - Ascending or Descending |
| \bal\specialtycriteria\auditors |
No |
Auditors |
ID Value from GetAdvancedSearchLookups |
| \bal\specialtycriteria\companykeyword |
No |
Company Keyword |
e.g. laptops or China or acquired, merged, takeover |
| \bal\specialtycriteria\duns |
No |
DUNS Number |
|
| \bal\specialtycriteria\exchange |
No |
Exchange |
ID Value from GetAdvancedSearchLookups |
| \bal\specialtycriteria\ranking |
No |
Rankings/Indices |
ID Value from GetAdvancedSearchLookups |
| \bal\specialtycriteria\ukregistration |
No |
UK Registration Number |
e.g. 3443456 or 3443456, 0764797 |
| \bal\specialtycriteria\ukvat |
No |
UK Vat Number |
e.g. 906565610 or 906565610, 466264724 |
| \bal\specialtycriteria\yearfoundingfrom |
No |
Year of Founding or Change in Control Lower Bound |
YYYY |
| \bal\specialtycriteria\yearfoundingto |
No |
Year of Founding or Change in Control (YYYY) Upper Bound |
YYYY |
| \bal\hitOffset |
No |
Greater than or equal to 1 but less than or equal to 10,000. Default = 1 |
Paging support, first record returned will be hitOffset |
5.3.3 Sample XML Request
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:web="http://webservice.hoovers.com">
<soapenv:Header>
<web:API-KEY>YOUR-API-KEY</web:API-KEY>
</soapenv:Header>
<soapenv:Body>
<web:AdvancedPersonSearchRequest>
<web:bal>
<web:companysize>
<web:employeesFrom></web:employeesFrom>
<web:employeesGrowthFrom></web:employeesGrowthFrom>
<web:employeesGrowthTo></web:employeesGrowthTo>
<web:employeesThisLocationFrom></web:employeesThisLocationFrom>
<web:employeesThisLocationTo></web:employeesThisLocationTo>
<web:employeesTo></web:employeesTo>
<web:marketCapFrom></web:marketCapFrom>
<web:marketCapTo></web:marketCapTo>
<web:salesFrom></web:salesFrom>
<web:salesGrowthFrom></web:salesGrowthFrom>
<web:salesGrowthTo></web:salesGrowthTo>
<web:salesTo></web:salesTo>
</web:companysize>
<web:companytype>
<web:location></web:location>
<web:publicPrivate></web:publicPrivate>
<web:status></web:status>
</web:companytype>
<web:financialdata>
<web:advertisingExpenseFrom></web:advertisingExpenseFrom>
<web:advertisingExpenseTo></web:advertisingExpenseTo>
<web:assetsFrom></web:assetsFrom>
<web:assetsTo></web:assetsTo>
<web:filingDateFrom></web:filingDateFrom>
<web:filingDateTo></web:filingDateTo>
<web:fiscalYearEnd></web:fiscalYearEnd>
<web:incomeFrom></web:incomeFrom>
<web:incomeGrowthFrom></web:incomeGrowthFrom>
<web:incomeGrowthTo></web:incomeGrowthTo>
<web:incomeTo></web:incomeTo>
<web:offerFrom></web:offerFrom>
<web:offerTo></web:offerTo>
<web:priceRangeFrom></web:priceRangeFrom>
<web:priceRangeTo></web:priceRangeTo>
<web:researchExpenseFrom></web:researchExpenseFrom>
<web:researchExpenseTo></web:researchExpenseTo>
<web:tradingDateFrom></web:tradingDateFrom>
<web:tradingDateTo></web:tradingDateTo>
<web:underwriters></web:underwriters>
</web:financialdata>
<web:industry>
<web:hooversIndustryName></web:hooversIndustryName>
<web:nAICS></web:nAICS>
<web:sIAC></web:sIAC>
</web:industry>
<web:location>
<web:areaCode></web:areaCode>
<web:city></web:city>
<web:country></web:country>
<web:globalState></web:globalState>
<web:metropolitan></web:metropolitan>
<web:region></web:region>
<web:state></web:state>
<web:zip></web:zip>
<web:zipAreaScale></web:zipAreaScale>
<web:zipAreaWithin></web:zipAreaWithin>
<web:zipAreaZipCode></web:zipAreaZipCode>
<web:allAny></web:allAny>
<web:ukCounty></web:ukCounty>
</web:location>
<web:orderBy></web:orderBy>
<web:people>
<web:ageFrom>20</web:ageFrom>
<web:ageTo>30</web:ageTo>
<web:bonusFrom></web:bonusFrom>
<web:bonusTo></web:bonusTo>
<web:jobFunction></web:jobFunction>
<web:keyWordsIn></web:keyWordsIn>
<web:keywordSelect></web:keywordSelect>
<web:salaryFrom>150000</web:salaryFrom>
<web:salaryTo>400000</web:salaryTo>
<web:totalPayFrom></web:totalPayFrom>
<web:totalPayTo></web:totalPayTo>
</web:people>
<web:sortDirection></web:sortDirection>
<web:specialtyCriteria>
<web:auditors></web:auditors>
<web:companyKeyword></web:companyKeyword>
<web:duns></web:duns>
<web:exchange></web:exchange>
<web:ranking></web:ranking>
<web:uKRegistration></web:uKRegistration>
<web:uKVAT></web:uKVAT>
<web:yearFoundingFrom></web:yearFoundingFrom>
<web:yearFoundingTo></web:yearFoundingTo>
</web:specialtyCriteria>
<web:hitOffset>300</web:hitOffset>
</web:bal>
</web:AdvancedPersonSearchRequest>
</soapenv:Body>
</soapenv:Envelope>
5.3.4 Output Parameters
| Field Name |
Value |
Notes |
| \return\officials\firsthit |
First Hit |
|
| \return\officials\hit\co-official-results\co-official-id |
Hoovers Officer ID |
|
| \return\officials\hit\co-official-results\company-id |
Hoovers Company ID |
|
| \return\officials\hit\co-official-results\pnamefirst |
Person First Name |
|
| \return\officials\hit\co-official-results\pnamelast |
Person Last Name |
|
| \return\officials\hit\co-official-results\pnamemiddle |
Person Middle Name |
|
| \return\officials\hit\co-official-results\psuffix |
Person Suffix |
|
| \return\officials\hit\co-official-results\ptitle |
Person Title |
|
| \return\officials\hit\co-official-results\recname |
Company Name |
|
| \return\officials\hit\number |
Hit Number |
|
| \return\officials\hits |
Total Nunber of Hits in this Response |
|
| \return\officials\lasthit |
Last Hit |
|
| \return\officials\total-hits |
Aggregate Total Number of Hits |
This is the total number of results the search returned |
5.3.5 Sample XML Response
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Body>
<web:AdvancedPersonSearchResponse xmlns:web="http://webservice.hoovers.com">
<web:return>
<web:people>
<web:first-hit>1</web:first-hit>
<web:hit>
<web:co-official-results>
<web:co-official-id>1212548</web:co-official-id>
<web:company-id>12636001141860</web:company-id>
<web:pnamefirst>Vitaly</web:pnamefirst>
<web:pnamelast>Spassky</web:pnamelast>
<web:pnamemiddle/>
<web:psuffix/>
<web:ptitle>SVP, Business Development</web:ptitle>
<web:recname>Moscow CableCom Corp.</web:recname>
</web:co-official-results>
<web:number>1</web:number>
</web:hit>
...
<web:hits>14</web:hits>
<web:last-hit>14</web:last-hit>
<web:total-hits>567</web:total-hits>
</web:people>
</web:return>
</web:AdvancedPersonSearchResponse>
</soapenv:Body>
</soapenv:Envelope>
5.4 Get Person Detail Simple
5.4.1 Overview
Returns a reduced subset of person details for a given Unique Official ID
5.4.2 Input Parameters
| Field Name |
Required |
Value |
Notes |
| uniqueId |
Yes |
Official ID |
|
5.4.3 Sample XML Request
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:web="http://webservice.hoovers.com">
<soapenv:Header>
<web:API-KEY>YOUR-API-KEY</web:API-KEY>
</soapenv:Header>
<soapenv:Body>
<web:GetPersonDetailSimpleRequest>
<web:uniqueId>1253484</web:uniqueId>
</web:GetPersonDetailSimpleRequest>
</soapenv:Body>
</soapenv:Envelope>
5.4.4 Output Parameters
| Field Name |
Value |
Type |
Notes |
| \return\official\co-official-id |
Co-Official Id |
UnsignedLong |
|
| \return\official\latest-position\title |
Title |
String |
|
| \return\official\latest-position\start-year |
Start Year |
String |
|
| \return\official\latest-position\end-year |
End Year |
String |
|
| \return\official\latest-salary\salary |
Salary in USD |
BigDecimal |
|
| \return\official\latest-salary\total-salary |
Total Salary in USD |
BigDecimal |
|
| \return\official\latest-salary\year |
Year |
UnsignedLong |
|
| \return\official\person\age |
Age |
Long |
|
| \return\official\person\first-name |
First Name |
String |
|
| \return\official\person\last-name |
Last Name |
String |
|
| \return\official\person\prefix |
Prefix |
String |
|
5.4.5 Sample XML Response
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Body>
<web:GetPersonDetailSimpleResponse xmlns:web="http://webservice.hoovers.com">
<web:return>
<web:official>
<web:co-official-id>12345</web:co-official-id>
<web:latest-position>
<web:title>CEO</web:title>
<web:start-year>2009</web:start-year>
<web:end-year>2009</web:end-year>
</web:latest-position>
<web:latest-salary>
<web:salary>95000</web:salary>
<web:total-salary>300000</web:total-salary>
<web:year>2009</web:year>
</web:latest-salary>
<web:person>
<web:age>50</web:age>
<web:first-name>Hoovers</web:first-name>
<web:last-name>Employee</web:last-name>
<web:prefix>Mr.</web:prefix>
<web:person>
</web:official>
</web:return>
</web:GetPersonDetailSimpleResponse>
</soapenv:Body>
</soapenv:Envelope>
6. Queries - Lookup Information
6.1 Get Advanced Search Lookups
6.1.1 Overview
This service is used to find certain request input element values for Advanced Company Search and Advanced Person Search (ex. country codes, stock exchanges, Hoover's industry codes). The specific elements are defined in each of the service operations above in sections 4.3.2 and 5.3.2. These values are relatively static, so caching this data can and should be taken advantage of with weekly refreshes as the suggested update timeframe. Do not make a call to this service every time you call the two Advanced Searches, as this call counts towards your overall total and it is a large amount of data.
6.1.2 Input Parameters
-None-
6.1.3 Sample XML Request
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Header>
<web:API-KEY>YOUR-API-KEY</web:API-KEY>
</soapenv:Header>
<soapenv:Body/>
</soapenv:Envelope>
6.1.4 Output Parameters
| Element Name |
Type |
Notes |
| /return/auditors/auditor/id |
int |
|
| /return/auditors/auditor/name |
string |
|
| /return/auditors/auditor/display-flag |
int |
|
| /return/company-types/co-type/id |
int |
|
| /return/company-types/co-type/name |
string |
|
| /return/company-types/co-type/sort-order |
int |
|
| /return/countries/country/id |
int |
|
| /return/countries/country/parent-id |
int |
|
| /return/countries/country/name |
string |
|
| /return/countries/country/short-name |
string |
|
| /return/countries/country/short-order |
int |
|
| /return/countries/country/phone-code |
int |
|
| /return/countries/country/display-flag |
int |
|
| /return/countries/country/sort-name |
string |
|
| /return/countries/country/continent-id |
int |
|
| /return/countries/country/region-od |
int |
|
| /return/countries/country/map-link |
int |
|
| /return/counties/county/id |
int |
|
| /return/counties/county/name |
string |
|
| /return/counties/county/country-id |
int |
|
| /return/stock-exchanges/exchange/id |
int |
|
| /return/stock-exchanges/exchange/exchange-type |
int |
|
| /return/stock-exchanges/exchange/name |
string |
|
| /return/stock-exchanges/exchange/is-major |
int |
|
| /return/stock-exchanges/exchange/quote-link |
url |
|
| /return/stock-exchanges/exchange/offsite |
int |
|
| /return/stock-exchanges/exchange/display-flag |
int |
|
| /return/stock-exchanges/exchange/country-id |
int |
|
| /return/hoovers-industries/hic-info/code |
int |
|
| /return/hoovers-industries/hic-info/name |
string |
|
| /return/hoovers-industries/hic-info/child-industries/hic-info/code |
int |
|
| /return/hoovers-industries/hic-info/child-industries/hic-info/name |
string |
|
| /return/location-types/location-type/id |
int |
|
| /return/location-types/location-type/name |
string |
|
| /return/metro-areas/metro-area/id |
int |
|
| /return/metro-areas/metro-area/name |
string |
|
| /return/metro-areas/metro-area/display-flag |
int |
|
| /return/metro-areas/metro-area/major-metro-flag |
int |
|
| /return/metro-areas/metro-area/short-name |
string |
|
| /return/job-functions/official-function/id |
int |
|
| /return/job-functions/official-function/name |
string |
|
| /return/job-functions/official-function/function-type-id |
int |
|
| /return/job-functions/official-function/display-flag |
int |
|
| /return/job-functions/official-function/display-order |
int |
|
| /return/ranking-types/ranking-type/id |
int |
|
| /return/ranking-types/ranking-type/name |
string |
|
| /return/ranking-types/ranking-type/description |
string |
|
| /return/ranking-types/ranking-type/url |
url |
|
| /return/ranking-types/ranking-type/display-order |
int |
|
| /return/ranking-types/ranking-type/current-year |
int |
|
| /return/ranking-types/ranking-type/edit-level |
int |
|
| /return/ranking-types/ranking-type/sort-name |
string |
|
| /return/ranking-types/ranking-type/has-position |
int |
|
| /return/ranking-types/ranking-type/record-status |
int |
|
| /return/ranking-types/ranking-type/hoov-display |
int |
|
| /return/ranking-types/ranking-type/partial-description |
string |
|
| /return/regions/region/id |
int |
|
| /return/regions/region/name |
string |
|
| /return/regions/region/parent |
int |
|
| /return/regions/region/display-flag |
int |
|
| /return/states/state-name/state |
string |
|
| /return/states/state-name/name |
string |
|
| /return/states/state-name/tax-rate |
float |
|
| /return/states/state-name/country-id |
int |
|
| /return/underwriters/underwriter/id |
int |
|
| /return/underwriters/underwriter/name |
string |
|
| /return/underwriters/underwriter/source |
string |
|
6.1.5 Sample XML Response
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Body>
<ns:GetAdvancedSearchLookupsResponse xmlns:ns="http://webservice.hoovers.com">
<ns:return xmlns:ax218="http://www.hoovers.com/xsd">
<ax218:r>
<auditors>
<auditor>
<id>2</id>
<name>A.F. Ferguson & Co.</name>
<display-flag>1</display-flag>
</auditor>
...
</auditors>
<company-types>
<co-type>
<id>1</id>
<name>Public</name>
<sort-order>0</sort-order>
</co-type>
...
</company-types>
<countries>
<country>
<id>76</id>
<parent-id>76</parent-id>
<name>United States</name>
<short-name>US</short-name>
<sort-order>10</sort-order>
<phone-code>1</phone-code>
<display-flag>1</display-flag>
<sort-name>united states</sort-name>
<continent-id>1</continent-id>
<region-id>7</region-id>
<map-link>1</map-link>
</country>
...
</countries>
<counties>
<county>
<id>1</id>
<name>Aberdeenshire</name>
<country-id>74</country-id>
</county>
...
</counties>
<stock-exchanges>
<exchange>
<id>1</id>
<exchange-type>1</exchange-type>
<name>NYSE</name>
<is-major>1</is-major>
<quote-link/>
<offsite>1</offsite>
<display-flag>1</display-flag>
<country-id>76</country-id>
</exchange>
...
</stock-exchanges>
<hoovers-industries>
<hic-info>
<code>1001</code>
<name>Aerospace & Defense</name>
<child-industries>
<hic-info>
<code>1002</code>
<name>Aerospace & Defense Maintenance & Service</name>
</hic-info>
...
</child-industries>
</hic-info>
...
</hoovers-industries>
<location-types>
<location-type>
<id>0</id>
<name>Single Location</name>
</location-type>
...
</location-types>
<metro-areas>
<metro-area>
<id>10180</id>
<name>Abilene, TX</name>
<display-flag>1</display-flag>
<major-metro-flag>0</major-metro-flag>
<short-name/>
</metro-area>
...
</metro-areas>
<job-functions>
<official-function>
<id>5</id>
<name>Administration</name>
<function-type-id>1</function-type-id>
<display-flag>1</display-flag>
<display-order>50</display-order>
</official-function>
...
</job-functions>
<ranking-types>
<rank-type>
<id>6</id>
<name>Hoover's Top Employers</name>
<description>Welcome to Hoover's pick of the largest and fastest-growing employers. To be included, a company must...</description>
<url/>
<display-order>0</display-order>
<current-year>0</current-year>
<edit-level>1</edit-level>
<sort-name>Hoover's Top Employers</sort-name>
<has-position>0</has-position>
<record-status>0</record-status>
<hoov-display>0</hoov-display>
<partial-description/>
</rank-type>
...
</ranking-types>
<regions>
<region>
<id>1</id>
<name>Africa</name>
<parent>1</parent>
<display-flag>1</display-flag>
</region>
...
</regions>
<states>
<state-name>
<state>AL</state>
<name>Alabama</name>
<tax-rate>9.0</tax-rate>
<country-id>76</country-id>
</state-name>
...
</states>
<underwriters>
<underwriter>
<id>5</id>
<name>A.G. Edwards & Sons, Inc.</name>
<source/>
</underwriter>
...
</underwriters>
</ax218:r>
</ns:return>
</ns:GetAdvancedSearchLookupsResponse>
</soapenv:Body>
</soapenv:Envelope>
7. Queries - Industry Information
Industry information is provided by First Research. In the Development environment, there will be limited sample industry data. Production contains hundreds of industry profiles.
7.1 Get All Industries Lookup
7.1.1 Overview
This service is used to retrieve profile Ids, North American Industry Classification System (NAICS) and Standard Industrial Classification (SIC) codes for industries. These values are relatively static, so caching this data can and should be taken advantage of with refreshes every 5 days as the suggested update time frame. Do not make a call to this service every time you need an Id or code, as this call counts towards your overall total and it is a large amount of data.
7.1.2 Input Parameters
-None-
7.1.3 Sample XML Request
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:web="http://webservice.hoovers.com">
<soapenv:Header>
<web:API-KEY>YOUR-API-KEY</web:API-KEY>
</soapenv:Header>
<soapenv:Body>
<web:GetAllIndustriesLookup/>
</soapenv:Body>
</soapenv:Envelope>
7.1.4 Output Parameters
| Element Name |
Type |
Notes |
| /return/industries |
Collection of Industry elements. |
|
| /return/industries/industry |
Industry element data. |
|
| /return/industries/industry/name |
string |
Industry Name |
| /return/industries/industry/sicCodes |
string |
Comma separated list of SIC codes. |
| /return/industries/industry/naicsCodes |
string |
Comma separated list of NAICS codes. |
| /return/industries/industry/profileId |
string |
Profile Id of the industry. |
| /return/industries/industry/lastUpdated |
string |
Last updated date. |
| /return/industries/industry/categories |
Collection of Category elements. |
|
| /return/industries/industry/categories/category |
string |
Category name of the industry. |
7.1.5 Sample XML Response
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Body>
<web:GetAllIndustriesLookupResponse xmlns:web="http://webservice.hoovers.com">
<web:return>
<web:industries>
<web:industry>
<web:name>Abrasives Manufacturing</web:name>
<web:sicCodes>3291</web:sicCodes>
<web:naicsCodes>32791</web:naicsCodes>
<web:profileId>116</web:profileId>
<web:lastUpdated>2/2/2009</web:lastUpdated>
<web:categories>
<web:category>Manufacturing</web:category>
...
</web:categories>
</web:industry>
...
</web:industries>
</web:return>
</web:GetAllIndustriesLookupResponse>
</soapenv:Body>
</soapenv:Envelope>
7.2 Get Call Prep Sheet
7.2.1 Overview
This call returns a Call Preparation Sheet from First Research API for a given Profile ID
7.2.2 Input Parameters
| Field Name |
Required |
Value |
Notes |
| profileId |
Yes |
Profile ID |
|
7.2.3 Sample XML Request
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:web="http://webservice.hoovers.com">
<soapenv:Header>
<web:API-KEY>YOUR-API-KEY</web:API-KEY>
</soapenv:Header>
<soapenv:Body>
<web:GetCallPrepSheetRequest>
<web:profileId>231</web:profileId>
</web:GetCallPrepSheetRequest>
</soapenv:Body>
</soapenv:Envelope>
7.2.4 Output Parameters
| Element Name |
Type |
Notes |
| /return/industryName |
string |
Industry Name |
| /return/lastUpdate |
string |
Last Updated Date |
| /return/keyBusinessChallenges |
Collection of challenge elements |
|
| /return/keyBusinessChallenges/challenge |
Challenge element |
|
| /return/keyBusinessChallenges/challenge/title |
string |
Challenge title |
| /return/keyBusinessChallenges/challenge/description |
string |
Challenge description |
| /return/keyBusinessChallenges/challenge/question |
string |
Challenge question |
| /return/keyBusinessOpportunities |
Collection of opportunity elements |
|
| /return/keyBusinessOpportunities/opportunity |
Opportunity element |
|
| /return/keyBusinessOpportunities/opportunity/title |
string |
Opportunity title |
| /return/keyBusinessOpportunities/opportunity/description |
string |
Opportunity description |
| /return/keyBusinessOpportunities/opportunity/question |
string |
Opportunity question |
| /return/fastFacts |
Collection of fact elements |
|
| /return/fastFacts/fact |
string |
Fact element |
| /return/executiveTalkingPoints |
Collection of talkingPoint elements |
|
| /return/executiveTalkingPoints/talkingPoint |
TalkingPoint elements |
|
| /return/executiveTalkingPoints/talkingPoint/role |
string |
TalkingPoint Role |
| /return/executiveTalkingPoints/talkingPoint/focusIssue |
string |
TalkingPoint Focus Issue |
| /return/executiveTalkingPoints/talkingPoint/callPrepQuestion |
string |
TalkingPoint Call Prep Question |
7.2.5 Sample XML Response
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Body>
<web:GetCallPrepSheetResponse xmlns:web="http://webservice.hoovers.com">
<web:return>
<web:industryName>Aquaculture</web:industryName>
<web:lastUpdate>12/29/2008</web:lastUpdate>
<web:keyBusinessChallenges>
<web:challenge>
<web:title>Competition</web:title>
<web:description>Fish imports, a major competitor....</web:description>
<web:question>How have fish imports impacted...</web:question>
</web:challenge>
...
</web:keyBusinessChallenges>
<web:keyBusinessOpportunities>
<web:opportunity>
<web:title>Offshore</web:title>
<web:description>Although the outcome of....</web:description>
<web:question>Does the company favor...</web:question>
</web:opportunity>
...
</web:keyBusinessOpportunities>
<web:fastFacts>
<web:fact>The US aquaculture industry includes...</web:fact>
...
</web:fastFacts>
<web:executiveTalkingPoints>
<web:talkingPoint>
<web:role>CEO</web:title>
<web:focusIssue>Selecting Stock</web:description>
<web:question>What types or stages of fish...</web:question>
</web:talkingPoint>
...
</web:executiveTalkingPoints>
</web:return>
</web:GetCallPrepSheetResponse>
</soapenv:Body>
</soapenv:Envelope>
7.3 Get Industry Profile
7.3.1 Overview
This call returns Industry Profile information from the First Research API by SIC, NAICS or profileId.
7.3.2 Input Parameters
| Field Name |
Required |
Value |
Notes |
| industryCodeType |
Yes |
Valid values are 'sic', 'naics', or 'profileId' |
|
| industryCode |
Yes |
string - The value of the corresponding code type to search on. |
|
| chapters |
No |
Collection of chapter elements. |
|
| chapter |
No |
string - The chapter number to retrieve. |
Valid chapter numbers range from 0 to 10. |
7.3.3 Sample XML Request
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:web="http://webservice.hoovers.com">
<soapenv:Header>
<web:API-KEY>YOUR-API-KEY</web:API-KEY>
</soapenv:Header>
<soapenv:Body>
<web:GetIndustryProfileRequest>
<web:industryCodeType>sic</web:industryCodeType>
<web:industryCode>3400</web:industryCode>
<web:chapters>
<web:chapter>2</web:chapter>
...
</web:chapters>
</web:GetIndustryProfileRequest>
</soapenv:Body>
</soapenv:Envelope>
7.3.4 Output Parameters
| Element Name |
Type |
Notes |
| /return/errorCode |
string |
Error code returned by First Research if request results in an error. |
| /return/errorMessage |
string |
Error message returned by First Research if request results in an error. |
| /return/exactMatches |
Container for industryProfiles element. |
|
| /return/exactMatches/industryProfiles |
Collection of industryProfile elements. |
|
| /return/groupMatches |
Container for industryProfiles element. |
|
| /return/groupMatches/industryProfiles |
Collection of industryProfile elements. |
|
| /return/majorGroupMatches |
Container for industryProfiles element. |
|
| /return/majorGroupMatches/industryProfiles |
Collection of industryProfile elements. |
|
| /return/usIndustryMatches |
Container for industryProfiles element. |
|
| /return/usIndustryMatches/industryProfiles |
Collection of industryProfile elements. |
|
| /return/industryMatches |
Container for industryProfiles element. |
|
| /return/industryMatches/industryProfiles |
Collection of industryProfile elements. |
|
| /return/industryGroupMatches |
Container for industryProfiles element. |
|
| /return/industryGroupMatches/industryProfiles |
Collection of industryProfile elements. |
|
| /return/industrySubsectorMatches |
Container for industryProfiles element. |
|
| /return/industrySubsectorMatches/industryProfiles |
Collection of industryProfile elements. |
|
| /return/industrySectorMatches |
Container for industryProfiles element. |
|
| /return/industrySectorMatches/industryProfiles |
Collection of industryProfile elements. |
|
| /return/industryProfile |
Industry Profile data |
|
| /return/industryProfile/errorCode |
string |
Error code returned by First Research if request results in an error. |
| /return/industryProfile/errorMessage |
string |
Error message returned by First Research if request results in an error. |
| /return/industryProfile/industryName |
string |
Industry Name |
| /return/industryProfile/profileID |
string |
Profile ID |
| /return/industryProfile/lastUpdate |
string |
Last updated date. |
| /return/industryProfile/categories |
Collection of category elements. |
|
| /return/industryProfile/categories/category |
string |
Category associated with this industry profile. |
| /return/industryProfile/sicCodes |
Collection of sicCode elements. |
|
| /return/industryProfile/sicCodes/sicCode |
string |
SIC code associated with this industry profile. |
| /return/industryProfile/naicsCodes |
Collection of naicsCode elements. |
|
| /return/industryProfile/naicsCodes/naicsCode |
string |
NAICS code associated with this industry profile. |
| /return/industryProfile/relatedProfiles |
Collection of relatedProfile elements. |
|
| /return/industryProfile/relatedProfiles/relatedProfile |
Related Profile data |
|
| /return/industryProfile/relatedProfiles/relatedProfile/industryName |
string |
Related Profile industry name. |
| /return/industryProfile/relatedProfiles/relatedProfile/profileID |
string |
Related profile ID. |
| /return/industryProfile/disclaimer |
string |
First Research Disclaimer text. |
| /return/industryProfile/chapters |
Collection of chapter elements |
|
| /return/industryProfile/chapters/chapter |
Chapter data. |
|
| /return/industryProfile/chapters/chapter/name |
string |
Chapter name. |
| /return/industryProfile/chapters/chapter/description |
string |
Chapter description. |
| /return/industryProfile/chapters/chapter/paragraphs |
Collection of paragraph elements. |
|
| /return/industryProfile/chapters/chapter/paragraphs/paragraph |
Paragraph data. |
|
| /return/industryProfile/chapters/chapter/paragraphs/paragraph/category |
string |
Paragraph category. |
| /return/industryProfile/chapters/chapter/paragraphs/paragraph/title |
string |
Paragraph title. |
| /return/industryProfile/chapters/chapter/paragraphs/paragraph/tableHeader |
string |
Paragraph table header. |
| /return/industryProfile/chapters/chapter/paragraphs/paragraph/contents |
string |
Paragraph contents. |
| /return/industryProfile/chapters/chapter/paragraphs/paragraph/tableFooter |
string |
Paragraph table footer. |
| /return/industryProfile/chapters/chapter/paragraphs/paragraph/imageURL |
string |
Paragraph image URL. |
| /return/industryProfile/chapters/chapter/paragraphs/paragraph/siteURL |
string |
Paragraph site URL. |
| /return/industryProfile/chapters/chapter/paragraphs/paragraph/bullets |
Collection of bullet elements. |
|
| /return/industryProfile/chapters/chapter/paragraphs/paragraph/bullets |
Collection of bullet elements. |
|
| /return/industryProfile/chapters/chapter/paragraphs/paragraph/bullets/bullet |
string |
Paragraph bullet. |
| /return/industryProfile/chapters/chapter/subChapters |
Collection of subChapter elements. |
|
| /return/industryProfile/chapters/chapter/subChapters/subChapter |
Chapter element. |
|
7.3.5 Sample XML Response
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Body>
<web:GetIndustryProfileResponse xmlns:web="http://webservice.hoovers.com">
<web:return>
<web:errorCode/>
<web:errorMessage/>
<web:exactMatches>
<web:industryProfiles>
<web:industryProfile>
<web:errorCode/>
<web:errorMessage/>
<web:industryName>Advertising and Marketing</web:industryName>
<web:profileID>53</web:profileID>
<web:lastUpdate>1/19/2009</web:lastUpdate>
<web:categories>
<web:category>Technology and Communications</web:category>
<web:category>Services</web:category>
</web:categories>
<web:sicCodes>
<web:sicCode>7311</web:sicCode>
<web:sicCode>7312</web:sicCode>
<web:sicCode>7313</web:sicCode>
<web:sicCode>7319</web:sicCode>
<web:sicCode>7331</web:sicCode>
<web:sicCode>8743</web:sicCode>
</web:sicCodes>
<web:naicsCodes>
<web:naicsCode>5418</web:naicsCode>
</web:naicsCodes>
<web:relatedProfiles>
<web:relatedProfile>
<web:industryName>Municipal Governments</web:industryName>
<web:profileID>95</web:profileID>
</web:relatedProfile>
</web:relatedProfiles>
<web:disclaimer>The purpose of the Profiles is for sales call ...</web:disclaimer>
<web:chapters>
<web:chapter>
<web:name>Industry Overview</web:name>
<web:description/>
<web:paragraphs>
<web:paragraph>
<web:category/>
<web:title/>
<web:tableHeader/>
<web:contents>The US fabricated metal products industry consists of about 60,000 companies ...</web:contents>
<web:tableFooter/>
<web:imageURL/>
<web:siteURL/>
<web:bullets>
<web:bullet>bullet1</web:bullet>
...
<web:bullets>
</web:paragraph>
...
</web:paragraphs>
<web:subChapters>
<web:subChapter>
<web:name>Industry Overview - Competitive Landscape</web:name>
<web:description/>
<web:paragraphs>
<web:paragraph>
<web:category/>
<web:title/>
<web:tableHeader/>
<web:contents><![CDATA[Demand is driven largely by the needs of other industrial companies, and is therefore linked to ...]]></web:contents>
<web:tableFooter/>
<web:imageURL/>
<web:siteURL/>
<web:bullets/>
</web:paragraph>
</web:paragraphs>
</web:subChapter>
...
</web:subChapters>
</web:chapter>
...
</web:chapters>
</web:industryProfile>
...
</web:industryProfiles>
</web:exactMatches>
<web:groupMatches/>
<web:majorGroupMatches/>
<web:industryProfile/>
<web:usIndustryMatches/>
<web:industryMatches/>
<web:industryGroupMatches/>
<web:industrySubsectorMatches/>
<web:industrySectorMatches/>
</web:return>
</web:GetIndustryProfileResponse>
</soapenv:Body>
</soapenv:Envelope>
7.4 Find Industry Profiles By Keyword
7.4.1 Overview
This call returns Industry Profiles from First Research API that match the keyword sent in the request.
7.4.2 Input Parameters
| Field Name |
Required |
Value |
Notes |
| keyword |
Yes |
String |
|
7.4.3 Sample XML Request
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:web="http://webservice.hoovers.com">
<soapenv:Header>
<web:API-KEY>YOUR-API-KEY</web:API-KEY>
</soapenv:Header>
<soapenv:Body>
<web:FindIndustryProfilesByKeywordRequest>
<web:keyword>printing</web:keyword>
</web:FindIndustryProfilesByKeywordRequest>
</soapenv:Body>
</soapenv:Envelope>
7.4.4 Output Parameters
| Element Name |
Type |
Notes |
| /return/industries |
Collection of Industry elements. |
|
| /return/industry |
Industry Profile data |
|
| /return/industryProfile/industryName |
string |
Industry Name |
| /return/industryProfile/profileID |
string |
Profile ID |
| /return/industryProfile/lastUpdated |
string |
Last updated date. |
| /return/industryProfile/categories |
Collection of category elements. |
|
| /return/industryProfile/categories/category |
string |
Category associated with this industry profile. |
| /return/industryProfile/sicCodes |
Comma separated string. |
SIC codes associated with this industry profile. |
| /return/industryProfile/naicsCodes |
Comma separated string. |
NAICS codes associated with this industry profile. |
7.4.5 Sample XML Response
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Body>
<web:FindIndustryProfilesByKeywordResponse xmlns:web="http://webservice.hoovers.com">
<web:return>
<web:industries>
<web:industry>
<web:industryName>Abrasives Manufacturing</web:industryName>
<web:sicCodes>3291</web:sicCodes>
<web:naicsCodes>32791</web:naicsCodes>
<web:profileID>116</web:profileID>
<web:lastUpdated>2/2/2009</web:lastUpdated>
<web:categories>
<web:category>Manufacturing</web:category>
...
</web:categories>
</web:industry>
...
</web:industries>
</web:return>
</web:FindIndustryProfilesByKeywordResponse>
</soapenv:Body>
</soapenv:Envelope>
7.5 Get State or Province Profile
7.5.1 Overview
This call returns State or Province profile data from First Research API by profile Id.
7.5.2 Input Parameters
| Field Name |
Required |
Value |
Notes |
| stateOrProvinceType |
Yes |
String |
Valid values are 'state' or 'province' (see StateOrProvinceTypes in WSDL) |
| stateOrProvinceId |
Yes |
string |
ID Value (the state or province to be searched) from GetAdvancedSearchLookups |
7.5.3 Sample XML Request
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:web="http://webservice.hoovers.com">
<soapenv:Header>
<web:API-KEY>YOUR-API-KEY</web:API-KEY>
</soapenv:Header>
<soapenv:Body>
<web:GetStateOrProvinceProfileRequest>
<web:stateOrProvinceId>MD</web:stateOrProvinceId>
<web:stateOrProvinceType>state</web:stateOrProvinceType>
</web:GetStateOrProvinceProfileRequest>
</soapenv:Body>
</soapenv:Envelope>
7.5.4 Output Parameters
| Element Name |
Type |
Notes |
| /return/errorCode |
string |
Error code returned by First Research if request results in an error. |
| /return/errorMessage |
string |
Error message returned by First Research if request results in an error. |
| /return/stateProfile |
State Profile element. |
|
| /return/stateProfile/id |
string |
State or Province ID. |
| /return/stateProfile/stateName |
string |
State or Province Name. |
| /return/stateProfile/lastUpdate |
string |
Last updated date. |
| /return/stateProfile/code |
string |
State or Province code. |
| /return/stateProfile/image |
string |
State or Province image. |
| /return/stateProfile/relatedProfiles |
Container for relatedProfile elements. |
|
| /return/stateProfile/relatedProfiles/relatedProfile |
RelatedProfile element. |
|
| /return/stateProfile/relatedProfiles/relatedProfile/industryName |
string |
Industry Name element. |
| /return/stateProfile/relatedProfiles/relatedProfile/profileID |
string |
Industry profileID. |
| /return/stateProfile/bigPicture |
Container for chapter element. |
|
| /return/stateProfile/bigPicture/name |
string |
Chapter name. |
| /return/stateProfile/bigPicture/description |
string |
Chapter description. |
| /return/stateProfile/bigPicture/paragraphs |
Paragraphs element |
|
| /return/stateProfile/bigPicture/subChapters |
Subchapters element |
|
| /return/stateProfile/employmentData |
Container for anyTypes element. |
|
| /return/stateProfile/employmentData/anyTypes |
Container for anyType elements. |
|
| /return/stateProfile/employmentData/anyTypes/anyType |
Any valid WSDl type. |
|
| /return/stateProfile/industryUpdate |
Container for chapter element. |
|
| /return/stateProfile/industryUpdate/name |
string |
Chapter name. |
| /return/stateProfile/industryUpdate/description |
string |
Chapter description. |
| /return/stateProfile/industryUpdate/paragraphs |
Paragraphs element |
|
| /return/stateProfile/industryUpdate/subChapters |
Subchapters element |
|
| /return/stateProfile/localRealEstateSummary |
Container for chapter element. |
|
| /return/stateProfile/localRealEstateSummary/name |
string |
Chapter name. |
| /return/stateProfile/localRealEstateSummary/description |
string |
Chapter description. |
| /return/stateProfile/localRealEstateSummary/paragraphs |
Paragraphs element |
|
| /return/stateProfile/localRealEstateSummary/subChapters |
Subchapters element |
|
| /return/stateProfile/weblinks |
Container for anyTypes element. |
|
| /return/stateProfile/weblinks/anyTypes |
Container for anyType elements. |
|
| /return/stateProfile/weblinks/anyTypes/anyType |
Any valid WSDl type. |
|
| /return/stateProfile/chapters |
Collection of chapter elements |
|
| /return/stateProfile/chapters/chapter |
Chapter data. |
|
| /return/stateProfile/chapters/chapter/name |
string |
Chapter name. |
| /return/stateProfile/chapters/chapter/description |
string |
Chapter description. |
| /return/stateProfile/chapters/chapter/paragraphs |
Collection of paragraph elements. |
|
| /return/stateProfile/chapters/chapter/paragraphs/paragraph |
Paragraph data. |
|
| /return/stateProfile/chapters/chapter/paragraphs/paragraph/category |
string |
Paragraph category. |
| /return/stateProfile/chapters/chapter/paragraphs/paragraph/title |
string |
Paragraph title. |
| /return/stateProfile/chapters/chapter/paragraphs/paragraph/tableHeader |
string |
Paragraph table header. |
| /return/stateProfile/chapters/chapter/paragraphs/paragraph/contents |
string |
Paragraph contents. |
| /return/stateProfile/chapters/chapter/paragraphs/paragraph/tableFooter |
string |
Paragraph table footer. |
| /return/stateProfile/chapters/chapter/paragraphs/paragraph/imageURL |
string |
Paragraph image URL. |
| /return/stateProfile/chapters/chapter/paragraphs/paragraph/siteURL |
string |
Paragraph site URL. |
| /return/stateProfile/chapters/chapter/paragraphs/paragraph/bullets |
Collection of bullet elements. |
|
| /return/stateProfile/chapters/chapter/paragraphs/paragraph/bullets |
Collection of bullet elements. |
|
| /return/stateProfile/chapters/chapter/paragraphs/paragraph/bullets/bullet |
string |
Paragraph bullet. |
| /return/stateProfile/chapters/chapter/subChapters |
Collection of subChapter elements. |
|
| /return/stateProfile/chapters/chapter/subChapters/subChapter |
Chapter element. |
|
| /return/stateProfile/disclaimer |
string |
First Research Disclaimer text. |
7.5.5 Sample XML Response
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Body>
<GetStateOrProvinceProfileResponse xmlns:web="http://webservice.hoovers.com">
<web:return>
<web:errorCode/>
<web:errorMessage/>
<web:stateProfile>
<web:id>STFL</web:id>
<web:stateName>Florida</web:stateName>
<web:lastUpdate>4th Quarter 2008</web:lastUpdate>
<web:code>123</web:code>
<web:image>http://access.firstresearch.com/images/flags/florida.gif</web:image>
<web:relatedProfiles>
<web:relatedProfile>
<web:industryName>Agriculture Crop Production</web:industryName>
<web:profileID>35</web:profileID>
<web:relatedProfile/>
...
</web:relatedProfiles>
<web:bigPicture>
<web:name>Industry Overview</web:name>
<web:description/>
<web:paragraphs>
<web:paragraph>
Element contents defined below
</web:paragraph>
...
</web:paragraphs>
<web:subChapters>
<web:subChapter>
Element contents defined below
</web:subChapter>
...
</web:subChapters>
</web:bigPicture>
<web:employmentData>
<web:anyTypes>
<web:anyType> </web:anyType>
...
</web:anyTypes>
</web:employmentData>
<web:industryUpdate>
<web:name>Industry Overview</web:name>
<web:description/>
<web:paragraphs>
<web:paragraph>
Element contents defined below
</web:paragraph>
...
</web:paragraphs>
<web:subChapters>
<web:subChapter>
Element contents defined below
</web:subChapter>
...
</web:subChapters>
</web:industryUpdate>
<web:localRealEstateSummary>
<web:name>Industry Overview</web:name>
<web:description/>
<web:paragraphs>
<web:paragraph>
Element contents defined below
</web:paragraph>
...
</web:paragraphs>
<web:subChapters>
<web:subChapter>
Element contents defined below
</web:subChapter>
...
</web:subChapters>
</web:localRealEstateSummary>
<web:weblinks>
<web:anyTypes>
<web:anyType> </web:anyType>
...
</web:anyTypes>
</web:weblinks>
<web:chapters>
<web:chapter>
<web:name>Industry Overview</web:name>
<web:description/>
<web:paragraphs>
<web:paragraph>
<web:category/>
<web:title/>
<web:tableHeader/>
<web:contents>The US fabricated metal products industry consists of about 60,000 companies that generate $300 billion of annual revenue. Large companies in specialty segments include Ball Corporation and Snap-On. Because of the special manufacturing processes involved, most companies make a limited range of products. The industry as a whole is<strong> fragmented</strong>: the largest 50 companies hold just 20 percent of the market, but concentration can be high in industry segments like cutlery, boilers, springs, and metal cans.</web:contents>
<web:tableFooter/>
<web:imageURL/>
<web:siteURL/>
<web:bullets>
<web:bullet>bullet1</web:bullet>
...
<web:bullets>
</web:paragraph>
...
</web:paragraphs>
<web:subChapters>
<web:subChapter>
<web:name>Industry Overview - Competitive Landscape</web:name>
<web:description/>
<web:paragraphs>
<web:paragraph>
<web:category/>
<web:title/>
<web:tableHeader/>
<web:contents><![CDATA[Demand is driven largely by the needs of other industrial companies, and is therefore linked to economic growth. The profitability of individual companies depends on <strong>technical expertise</strong> and efficient manufacturing operations. The <strong>specialized</strong> nature and use of many products allows smaller companies to compete effectively. Despite gains in labor productivity, the industry is still fairly <strong>labor-intensive</strong>: average annual revenue per worker is close to $150,000.]]></web:contents>
<web:tableFooter/>
<web:imageURL/>
<web:siteURL/>
<web:bullets/>
</web:paragraph>
</web:paragraphs>
</web:subChapter>
...
</web:subChapters>
</web:chapter>
...
</web:chapters>
<web:disclaimer>The purpose of the Profiles is for sales call ...</web:disclaimer>
<web:stateProfile/>
</web:return>
</GetStateOrProvinceProfileResponse>
</soapenv:Body>
</soapenv:Envelope>
8. Queries - Financial Information
8.1 Company Financial Summary
8.1.1 Overview
This call returns a summary of financial data for a given company id.
8.1.2 Input Parameters
| Field Name |
Required |
Value |
Notes |
| uniqueId |
Yes |
Company DUNS Number or Hoovers Company ID |
|
8.1.3 Sample XML Request
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:web="http://webservice.hoovers.com">
<soapenv:Header>
<web:API-KEY>Your API Key HERE</web:API-KEY>
</soapenv:Header>
<soapenv:Body>
<web:GetCompanyFinancialSummaryRequest>
<web:uniqueId>13193114315195</web:uniqueId>
</web:GetCompanyFinancialSummaryRequest>
</soapenv:Body>
</soapenv:Envelope>
8.1.4 Output Parameters
| Element Name |
Type |
Notes |
| return/basicFinancialInformation/companyType |
string |
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 |
string |
Ticker symbol for the company on the current exchange |
| return/basicFinancialInformation/exchanges/exchange/exchangeName |
string |
Name of the exchange the company is traded on. |
| return/basicFinancialInformation/location |
string |
Type of location for the company; headquarters, branch office, etc. |
| return/basicFinancialInformation/fiscalYearEnd |
string |
Latest fiscal year end |
| return/basicFinancialInformation/financialFilingsURL |
string |
Link to Hoover's Online for financial filings data. |
| return/basicFinancialInformation/currentYearSalesGrowth/year |
string |
The year for the latest year sales growth. |
| return/basicFinancialInformation/currentYearSalesGrowth/sales |
decimal |
The sales number in millions (USD) for the latest year sales growth. |
| return/basicFinancialInformation/oneYearSalesGrowthPct |
decimal |
The one year sales growth percent. |
| return/basicFinancialInformation/currentYearNetIncome/year |
string |
The year for the current year net income. |
| return/basicFinancialInformation/currentYearNetIncome/netIncome |
decimal |
The net income for the current year in millions (USD). |
| return/basicFinancialInformation/oneYearNetIncomeGrowthPct |
decimal |
The one year net income growth percent. |
| return/basicFinancialInformation/auditor |
string |
The name of the financial auditor for this company. |
| return/basicFinancialInformation/annualReportURL |
string |
Company URL to get the annual report for this company. |
| return/basicFinancialInformation/investorRelationsURL |
string |
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 |
string |
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 |
decimal |
The gross profit in millions (USD) claimed on the income statement. |
| return/annualIncomeStatements/[previousYears/previousYear | latestYear]/operatingIncome |
decimal |
The operating income in millions (USD) claimed on the income statement. |
| return/annualIncomeStatements/[previousYears/previousYear | latestYear]/totalNetIncome |
decimal |
The total net income in millions (USD) claimed on the income statement. |
| return/annualIncomeStatements/[previousYears/previousYear | latestYear]/dilutedEPS |
decimal |
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 |
string |
The year of the quarterly data |
| return/quarterlyIncomeStatements/[previousQuarters/previousQuarter | latestQuarter]/quarterMonth |
string |
The month of the quarterly data |
| return/quarterlyIncomeStatements/[previousQuarters/previousQuarter | latestQuarter]/revenue |
decimal |
The revenue for the quarter in millions (USD) |
| return/quarterlyIncomeStatements/[previousQuarters/previousQuarter | latestQuarter]/grossProfit |
decimal |
The gross profit for the quarter in millions (USD) |
| return/quarterlyIncomeStatements/[previousQuarters/previousQuarter | latestQuarter]/operatingIncome |
decimal |
The operating income for the quarter in millions (USD) |
| return/quarterlyIncomeStatements/[previousQuarters/previousQuarter | latestQuarter]/totalNetIncome |
decimal |
The total net income for the quarter in millions (USD) |
| return/quarterlyIncomeStatements/[previousQuarters/previousQuarter | latestQuarter]/dilutedEPS |
decimal |
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 |
decimal |
Price Sales Ratio |
| return/comparisonToIndustryAndMarket/company/priceEarningRatio |
decimal |
Price Earnings Ratio |
| return/comparisonToIndustryAndMarket/company/priceBookRatio |
decimal |
Price Book Ratio |
| return/comparisonToIndustryAndMarket/company/priceCashFlowRatio |
decimal |
Price Cash Flow Ratio |
| return/comparisonToIndustryAndMarket/industryMedian |
|
Container for Industry comarison ratio info |
| return/comparisonToIndustryAndMarket/industryMedian/priceSalesRatio |
decimal |
Price Sales Ratio |
| return/comparisonToIndustryAndMarket/industryMedian/priceEarningRatio |
decimal |
Price Earnings Ratio |
| return/comparisonToIndustryAndMarket/industryMedian/priceBookRatio |
decimal |
Price Book Ratio |
| return/comparisonToIndustryAndMarket/industryMedian/priceCashFlowRatio |
decimal |
Price Cash Flow Ratio |
| return/comparisonToIndustryAndMarket/marketMedian |
|
Container for Market comarison ratio info |
| return/comparisonToIndustryAndMarket/marketMedian/priceSalesRatio |
decimal |
Price Sales Ratio |
| return/comparisonToIndustryAndMarket/marketMedian/priceEarningRatio |
decimal |
Price Earnings Ratio |
| return/comparisonToIndustryAndMarket/marketMedian/priceBookRatio |
decimal |
Price Book Ratio |
| return/comparisonToIndustryAndMarket/marketMedian/priceCashFlowRatio |
decimal |
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 |
string |
Competitor name. |
| return/topCompetitors/competitor[1,2, or 3]/annualSales |
decimal |
The sales number in millions (USD) for this competitor. |
| return/topCompetitors/competitor[1,2, or 3]/employees |
unsignedLong |
The number of employees at this competitor. |
| return/topCompetitors/competitor[1,2, or 3]/marketCap |
decimal |
Competitor's market cap in millions (USD). |
8.1.5 Sample XML Response
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Body>
<web:GetCompanyFinancialSummaryResponse xmlns:web="http://webservice.hoovers.com">
<web:return>
<web:basicFinancialInformation>
<web:companyType>Public</web:companyType>
<web:exchanges>
<web:exchange>
<web:tickerSymbol>ACME</web:tickerSymbol>
<web:exchangeName>NYSE</web:exchangeName>
</web:exchange>
<web:exchange>
<web:tickerSymbol>ACME</web:tickerSymbol>
<web:exchangeName>London</web:exchangeName>
</web:exchange>
</web:exchanges>
<web:location>Headquarters</web:location>
<web:fiscalYearEnd>2007</web:fiscalYearEnd>
<web:financialFilingsURL>http://phpqapaid.hoovers.com/subscribe/co/sec.xhtml?Page=1&Sort=D&ID=hxxkttrffctjj</web:financialFilingsURL>
<web:currentYearSalesGrowth>
<web:year>2007</web:year>
<web:sales>291291.4</web:sales>
</web:currentYearSalesGrowth>
<web:oneYearSalesGrowthPct>10204.5</web:oneYearSalesGrowthPct>
<web:currentYearNetIncome>
<web:year>2007</web:year>
<web:netIncome>2478.0</web:netIncome>
</web:currentYearNetIncome>
<web:oneYearNetIncomeGrowthPct>-0.2</web:oneYearNetIncomeGrowthPct>
<web:auditor/>
<web:annualReportURL>http://www.acme.com/sectiongenericarticle.do?categoryId=9015498&contentId=7028087</web:annualReportURL>
<web:investorRelationsURL>http://www.acme.com/investorhome.do?categoryId=132&contentId=2004195</web:investorRelationsURL>
</web:basicFinancialInformation>
<web:annualIncomeStatements>
<web:latestYear>
<web:year>2008</web:year>
<web:revenue>22.1</web:revenue>
<web:grossProfit>22.1</web:grossProfit>
<web:operatingIncome>0.0</web:operatingIncome>
<web:totalNetIncome>0.0</web:totalNetIncome>
<web:dilutedEPS>0.00</web:dilutedEPS>
</web:latestYear>
<web:previousYears>
<web:previousYear>
<web:year>2006</web:year>
<web:revenue>23.6</web:revenue>
<web:grossProfit>23.6</web:grossProfit>
<web:operatingIncome>0.0</web:operatingIncome>
<web:totalNetIncome>-3.1</web:totalNetIncome>
<web:dilutedEPS>0.00</web:dilutedEPS>
</web:previousYear>
<web:previousYear>
<web:year>2004</web:year>
<web:revenue>11.0</web:revenue>
<web:grossProfit>11.0</web:grossProfit>
<web:operatingIncome>0.0</web:operatingIncome>
<web:totalNetIncome>0.3</web:totalNetIncome>
<web:dilutedEPS>0.00</web:dilutedEPS>
</web:previousYear>
</web:previousYears>
</web:annualIncomeStatements>
<web:quarterlyIncomeStatements>
<web:latestQuarter>
<web:quarterMonth>September</web:quarterMonth>
<web:quarterYear>2008</web:quarterYear>
<web:revenue>175.7</web:revenue>
<web:grossProfit>112.6</web:grossProfit>
<web:operatingIncome>9.7</web:operatingIncome>
<web:totalNetIncome>4.1</web:totalNetIncome>
<web:dilutedEPS>0.16</web:dilutedEPS>
</web:latestQuarter>
<web:previousQuarters>
<web:previousQuarter>
<web:quarterMonth>June</web:quarterMonth>
<web:quarterYear>2008</web:quarterYear>
<web:revenue>166.9</web:revenue>
<web:grossProfit>107.9</web:grossProfit>
<web:operatingIncome>-5.2</web:operatingIncome>
<web:totalNetIncome>-7.4</web:totalNetIncome>
<web:dilutedEPS>-0.17</web:dilutedEPS>
</web:previousQuarter>
<web:previousQuarter>
<web:quarterMonth>March</web:quarterMonth>
<web:quarterYear>2008</web:quarterYear>
<web:revenue>157.5</web:revenue>
<web:grossProfit>99.2</web:grossProfit>
<web:operatingIncome>-42.3</web:operatingIncome>
<web:totalNetIncome>171.1</web:totalNetIncome>
<web:dilutedEPS>3.96</web:dilutedEPS>
</web:previousQuarter>
</web:previousQuarters>
</web:quarterlyIncomeStatements>
<web:comparisonToIndustryAndMarket>
<web:company>
<web:priceSalesRatio>0.24</web:priceSalesRatio>
<web:priceEarningRatio>0.0</web:priceEarningRatio>
<web:priceBookRatio>0.74</web:priceBookRatio>
<web:priceCashFlowRatio>2.79</web:priceCashFlowRatio>
</web:company>
<web:industryMedian>
<web:priceSalesRatio>0.69</web:priceSalesRatio>
<web:priceEarningRatio>11.96</web:priceEarningRatio>
<web:priceBookRatio>2.27</web:priceBookRatio>
<web:priceCashFlowRatio>5.95</web:priceCashFlowRatio>
</web:industryMedian>
<web:marketMedian>
<web:priceSalesRatio>1.71</web:priceSalesRatio>
<web:priceEarningRatio>16.86</web:priceEarningRatio>
<web:priceBookRatio>1.62</web:priceBookRatio>
<web:priceCashFlowRatio>10.64</web:priceCashFlowRatio>
</web:marketMedian>
</web:comparisonToIndustryAndMarket>
<web:topCompetitors>
<web:competitor1>
<web:companyName>Sprocket Company</web:companyName>
<web:annualSales>118364.0</web:annualSales>
<web:employees>321000</web:employees>
<web:marketCap>116800.4</web:marketCap>
</web:competitor1>
<web:competitor2>
<web:companyName>ERM Corporation</web:companyName>
<web:annualSales>103630.0</web:annualSales>
<web:employees>0</web:employees>
<web:marketCap>171932.1</web:marketCap>
</web:competitor2>
<web:competitor3>
<web:companyName>Acmo Inc.</web:companyName>
<web:annualSales>14324.0</web:annualSales>
<web:employees>1489</web:employees>
<web:marketCap>1932.5</web:marketCap>
</web:competitor3>
</web:topCompetitors>
</web:return>
</web:GetCompanyFinancialSummaryResponse>
</soapenv:Body>
</soapenv:Envelope>
8.2 Company Financial Comparison
8.2.1 Overview
This call returns financial comparison data for a given company id.
8.2.2 Input Parameters
| Field Name |
Required |
Value |
Notes |
| uniqueId |
Yes |
Company DUNS Number or Hoovers Company ID |
|
8.2.3 Sample XML Request
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:web="http://webservice.hoovers.com">
<soapenv:Header>
<web:API-KEY>Your API Key HERE</web:API-KEY>
</soapenv:Header>
<soapenv:Body>
<web:GetCompanyComparisonDataRequest>
<web:uniqueId>13193114315195</web:uniqueId>
</web:GetCompanyComparisonDataRequest>
</soapenv:Body>
</soapenv:Envelope>
8.2.4 Output Parameters
| Element Name |
Type |
Notes |
| return/profitabilityComparison |
Profitability comparison data for industry median, market median, and the company. |
|
| return/profitabilityComparison/[company, industryMedian, or marketMedian]/pctGrossProfitMargin |
Decimal |
Gross profit margin. |
| return/profitabilityComparison/[company, industryMedian, or marketMedian]/pctPreTaxProfitMargin |
Decimal |
Pre-tax profit margin. |
| return/profitabilityComparison/[company, industryMedian, or marketMedian]/pctNetProfitMargin |
Decimal |
Net profit margin. |
| return/profitabilityComparison/[company, industryMedian, or marketMedian]/pctReturnOnEquity |
Decimal |
Return on equity. |
| return/profitabilityComparison/[company, industryMedian, or marketMedian]/pctReturnOnAssets |
Decimal |
Return on assets. |
| return/profitabilityComparison/[company, industryMedian, or marketMedian]/pctReturnOnInvestedCapital |
Decimal |
Return on invested capital. |
| return/valuationComparison |
Valuation comparison data for industry median, market median, and the company. |
|
| return/valuationComparison/[company, industryMedian, or marketMedian]/priceSalesRatio |
Decimal |
Price/Sales ratio. |
| return/valuationComparison/[company, industryMedian, or marketMedian]/priceEarningsRatio |
Decimal |
Price/Earnings ratio. |
| return/valuationComparison/[company, industryMedian, or marketMedian]/priceBookRatio |
Decimal |
Price/Book ratio. |
| return/valuationComparison/[company, industryMedian, or marketMedian]/priceCashFlowRatio |
Decimal |
Price/Cash Flow ratio. |
| return/operationsComparison |
Operations comparison data for industry median, market median, and the company. |
|
| return/operationsComparison/[company, industryMedian, or marketMedian]/daysOfSalesOutstanding |
Decimal |
Days of sales outstanding. |
| return/operationsComparison/[company, industryMedian, or marketMedian]/inventoryTurnover |
Decimal |
Inventory turnover. |
| return/operationsComparison/[company, industryMedian, or marketMedian]/daysCostOfGoodsSoldInInventory |
Decimal |
Days cost of goods sold in inventory. |
| return/operationsComparison/[company, industryMedian, or marketMedian]/assetTurnover |
Decimal |
Asset turnover. |
| return/operationsComparison/[company, industryMedian, or marketMedian]/netReceivablesTurnoverFlow |
Decimal |
Net receivables turnover flow. |
| return/operationsComparison/[company, industryMedian, or marketMedian]/pctEffectiveTaxRate |
Decimal |
Effective tax rate. |
| return/financialComparison |
Financial comparison data for industry median, market median, and the company. |
|
| return/financialComparison/[company, industryMedian, or marketMedian]/currentRatio |
Decimal |
Current Ratio |
| return/financialComparison/[company, industryMedian, or marketMedian]/quickRatio |
Decimal |
Quick Ratio |
| return/financialComparison/[company, industryMedian, or marketMedian]/leverageRatio |
Decimal |
Leverage Ratio |
| return/financialComparison/[company, industryMedian, or marketMedian]/totalDebtToEquity |
Decimal |
Total Debt/Equity |
| return/financialComparison/[company, industryMedian, or marketMedian]/interestCoverage |
Decimal |
Interest Coverage |
| return/perShareDataComparison |
Per Share data for industry median, market median, and the company. |
|
| return/perShareDataComparison/[company, industryMedian, or marketMedian]/revenuePerShare |
Decimal |
Revenue per share. |
| return/perShareDataComparison/[company, industryMedian, or marketMedian]/dividendsPerShare |
Decimal |
Dividends per share. |
| return/perShareDataComparison/[company, industryMedian, or marketMedian]/cashFlowPerShare |
Decimal |
Cash flow per share. |
| return/perShareDataComparison/[company, industryMedian, or marketMedian]/workingCapitalPerShare |
Decimal |
Working capital per share. |
| return/perShareDataComparison/[company, industryMedian, or marketMedian]/longTermDebtPerShare |
Decimal |
Long term debt per share. |
| return/perShareDataComparison/[company, industryMedian, or marketMedian]/bookValuePerShare |
Decimal |
Book value per share. |
| return/perShareDataComparison/[company, industryMedian, or marketMedian]/totalAssetsPerShare |
Decimal |
Total assets per share. |
| return/growthComparison |
Growth Comparison for industry median, market median, and the company. |
|
| return/growthComparison/[company, industryMedian, or marketMedian]/pctTwelveMonthRevenueGrowth |
Decimal |
12-Month Revenue Growth |
| return/growthComparison/[company, industryMedian, or marketMedian]/pctTwelveMonthNetIncomeGrowth |
Decimal |
12-Month Net Income Growth |
| return/growthComparison/[company, industryMedian, or marketMedian]/pctTwelveMonthEpsGrowth |
Decimal |
12-Month EPS Growth |
| return/growthComparison/[company, industryMedian, or marketMedian]/pctTwelveMonthDividendGrowth |
Decimal |
12-Month Dividend Growth |
| return/growthComparison/[company, industryMedian, or marketMedian]/pctThirtySixMonthRevenueGrowth |
Decimal |
36-Month Revenue Growth |
| return/growthComparison/[company, industryMedian, or marketMedian]/pctThirtySixMonthNetIncomeGrowth |
Decimal |
36-Month Net Income Growth |
| return/growthComparison/[company, industryMedian, or marketMedian]/pctThirtySixMonthEpsGrowth |
Decimal |
36-Month EPS Growth |
| return/growthComparison/[company, industryMedian, or marketMedian]/pctThirtySixMonthDividendGrowth |
Decimal |
36-Month Dividend Growth |
8.2.5 Sample XML Response
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Body>
<web:GetCompanyComparisonDataResponse xmlns:web="http://webservice.hoovers.com">
<web:return>
<web:profitabilityComparison>
<web:company>
<web:pctGrossProfitMargin>49.60</web:pctGrossProfitMargin>
<web:pctPreTaxProfitMargin>17.30</web:pctPreTaxProfitMargin>
<web:pctNetProfitMargin>11.00</web:pctNetProfitMargin>
<web:pctReturnOnEquity>16.2</web:pctReturnOnEquity>
<web:pctReturnOnAssets>10.6</web:pctReturnOnAssets>
<web:pctReturnOnInvestedCapital>14.3</web:pctReturnOnInvestedCapital>
</web:company>
<web:industryMedian>
<web:pctGrossProfitMargin>49.90</web:pctGrossProfitMargin>
<web:pctPreTaxProfitMargin>-2.30</web:pctPreTaxProfitMargin>
<web:pctNetProfitMargin>-1.70</web:pctNetProfitMargin>
<web:pctReturnOnEquity>5.7</web:pctReturnOnEquity>
<web:pctReturnOnAssets>-4.2</web:pctReturnOnAssets>
<web:pctReturnOnInvestedCapital>1.1</web:pctReturnOnInvestedCapital>
</web:industryMedian>
<web:marketMedian>
<web:pctGrossProfitMargin>52.90</web:pctGrossProfitMargin>
<web:pctPreTaxProfitMargin>5.60</web:pctPreTaxProfitMargin>
<web:pctNetProfitMargin>4.00</web:pctNetProfitMargin>
<web:pctReturnOnEquity>8.0</web:pctReturnOnEquity>
<web:pctReturnOnAssets>1.1</web:pctReturnOnAssets>
<web:pctReturnOnInvestedCapital>3.4</web:pctReturnOnInvestedCapital>
</web:marketMedian>
</web:profitabilityComparison>
<web:valuationComparison>
<web:company>
<web:priceSalesRatio>0.33</web:priceSalesRatio>
<web:priceEarningsRatio>8.16</web:priceEarningsRatio>
<web:priceBookRatio>2.14</web:priceBookRatio>
<web:priceCashFlowRatio>6.58</web:priceCashFlowRatio>
</web:company>
<web:industryMedian>
<web:priceSalesRatio>0.33</web:priceSalesRatio>
<web:priceEarningsRatio>8.16</web:priceEarningsRatio>
<web:priceBookRatio>2.14</web:priceBookRatio>
<web:priceCashFlowRatio>6.58</web:priceCashFlowRatio>
</web:industryMedian>
<web:marketMedian>
<web:priceSalesRatio>0.33</web:priceSalesRatio>
<web:priceEarningsRatio>8.16</web:priceEarningsRatio>
<web:priceBookRatio>2.14</web:priceBookRatio>
<web:priceCashFlowRatio>6.58</web:priceCashFlowRatio>
</web:marketMedian>
</web:valuationComparison>
<web:operationsComparison>
<web:company>
<web:daysOfSalesOutstanding>32.55</web:daysOfSalesOutstanding>
<web:inventoryTurnover>11.9</web:inventoryTurnover>
<web:daysCostOfGoodsSoldInInventory>31</web:daysCostOfGoodsSoldInInventory>
<web:assetTurnover>0.7</web:assetTurnover>
<web:netReceivablesTurnoverFlow>11.2</web:netReceivablesTurnoverFlow>
<web:pctEffectiveTaxRate>20.9</web:pctEffectiveTaxRate>
</web:company>
<web:industryMedian>
<web:daysOfSalesOutstanding>56.51</web:daysOfSalesOutstanding>
<web:inventoryTurnover>5.5</web:inventoryTurnover>
<web:daysCostOfGoodsSoldInInventory>66</web:daysCostOfGoodsSoldInInventory>
<web:assetTurnover>0.6</web:assetTurnover>
<web:netReceivablesTurnoverFlow>6.6</web:netReceivablesTurnoverFlow>
<web:pctEffectiveTaxRate>27.0</web:pctEffectiveTaxRate>
</web:industryMedian>
<web:marketMedian>
<web:daysOfSalesOutstanding>56.51</web:daysOfSalesOutstanding>
<web:inventoryTurnover>5.5</web:inventoryTurnover>
<web:daysCostOfGoodsSoldInInventory>66</web:daysCostOfGoodsSoldInInventory>
<web:assetTurnover>0.6</web:assetTurnover>
<web:netReceivablesTurnoverFlow>6.6</web:netReceivablesTurnoverFlow>
<web:pctEffectiveTaxRate>27.0</web:pctEffectiveTaxRate>
</web:marketMedian>
</web:operationsComparison>
<web:financialComparison>
<web:company>
<web:currentRatio>1.36</web:currentRatio>
<web:quickRatio>1.05</web:quickRatio>
<web:leverageRatio>6.20</web:leverageRatio>
<web:totalDebtToEquity>0.47</web:totalDebtToEquity>
<web:interestCoverage>11.2</web:interestCoverage>
</web:company>
<web:industryMedian>
<web:currentRatio>1.36</web:currentRatio>
<web:quickRatio>1.05</web:quickRatio>
<web:leverageRatio>6.20</web:leverageRatio>
<web:totalDebtToEquity>0.47</web:totalDebtToEquity>
<web:interestCoverage>11.2</web:interestCoverage>
</web:industryMedian>
<web:marketMedian>
<web:currentRatio>1.36</web:currentRatio>
<web:quickRatio>1.05</web:quickRatio>
<web:leverageRatio>6.20</web:leverageRatio>
<web:totalDebtToEquity>0.47</web:totalDebtToEquity>
<web:interestCoverage>11.2</web:interestCoverage>
</web:marketMedian>
</web:financialComparison>
<web:perShareDataComparison>
<web:company>
<web:revenuePerShare>26.6</web:revenuePerShare>
<web:dividendsPerShare>0.0</web:dividendsPerShare>
<web:cashFlowPerShare>1.77</web:cashFlowPerShare>
<web:workingCapitalPerShare>2.81</web:workingCapitalPerShare>
<web:longTermDebtPerShare>0.18</web:longTermDebtPerShare>
<web:bookValuePerShare>3.05</web:bookValuePerShare>
<web:totalAssetsPerShare>13.56</web:totalAssetsPerShare>
</web:company>
<web:industryMedian>
<web:revenuePerShare>7.54</web:revenuePerShare>
<web:dividendsPerShare>0.48</web:dividendsPerShare>
<web:cashFlowPerShare>0.38</web:cashFlowPerShare>
<web:workingCapitalPerShare>2.69</web:workingCapitalPerShare>
<web:longTermDebtPerShare>1.6</web:longTermDebtPerShare>
<web:bookValuePerShare>4.01</web:bookValuePerShare>
<web:totalAssetsPerShare>7.35</web:totalAssetsPerShare>
</web:industryMedian>
<web:marketMedian>
<web:revenuePerShare>5.36</web:revenuePerShare>
<web:dividendsPerShare>0.68</web:dividendsPerShare>
<web:cashFlowPerShare>0.39</web:cashFlowPerShare>
<web:workingCapitalPerShare>0.52</web:workingCapitalPerShare>
<web:longTermDebtPerShare>2.6</web:longTermDebtPerShare>
<web:bookValuePerShare>5.02</web:bookValuePerShare>
<web:totalAssetsPerShare>10.54</web:totalAssetsPerShare>
</web:marketMedian>
</web:perShareDataComparison>
<web:growthComparison>
<web:company>
<web:pctTwelveMonthRevenueGrowth>0.00</web:pctTwelveMonthRevenueGrowth>
<web:pctTwelveMonthNetIncomeGrowth>0.00</web:pctTwelveMonthNetIncomeGrowth>
<web:pctTwelveMonthEpsGrowth>10.44</web:pctTwelveMonthEpsGrowth>
<web:pctTwelveMonthDividendGrowth>-21.45</web:pctTwelveMonthDividendGrowth>
<web:pctThirtySixMonthRevenueGrowth>13.55</web:pctThirtySixMonthRevenueGrowth>
<web:pctThirtySixMonthNetIncomeGrowth>3.05</web:pctThirtySixMonthNetIncomeGrowth>
<web:pctThirtySixMonthEpsGrowth>13.56</web:pctThirtySixMonthEpsGrowth>
<web:pctThirtySixMonthDividendGrowth>13.56</web:pctThirtySixMonthDividendGrowth>
</web:company>
<web:industryMedian>
<web:pctTwelveMonthRevenueGrowth>0.00</web:pctTwelveMonthRevenueGrowth>
<web:pctTwelveMonthNetIncomeGrowth>0.00</web:pctTwelveMonthNetIncomeGrowth>
<web:pctTwelveMonthEpsGrowth>10.44</web:pctTwelveMonthEpsGrowth>
<web:pctTwelveMonthDividendGrowth>-21.45</web:pctTwelveMonthDividendGrowth>
<web:pctThirtySixMonthRevenueGrowth>13.55</web:pctThirtySixMonthRevenueGrowth>
<web:pctThirtySixMonthNetIncomeGrowth>3.05</web:pctThirtySixMonthNetIncomeGrowth>
<web:pctThirtySixMonthEpsGrowth>13.56</web:pctThirtySixMonthEpsGrowth>
<web:pctThirtySixMonthDividendGrowth>13.56</web:pctThirtySixMonthDividendGrowth>
</web:industryMedian>
<web:marketMedian>
<web:pctTwelveMonthRevenueGrowth>0.00</web:pctTwelveMonthRevenueGrowth>
<web:pctTwelveMonthNetIncomeGrowth>0.00</web:pctTwelveMonthNetIncomeGrowth>
<web:pctTwelveMonthEpsGrowth>10.44</web:pctTwelveMonthEpsGrowth>
<web:pctTwelveMonthDividendGrowth>-21.45</web:pctTwelveMonthDividendGrowth>
<web:pctThirtySixMonthRevenueGrowth>13.55</web:pctThirtySixMonthRevenueGrowth>
<web:pctThirtySixMonthNetIncomeGrowth>3.05</web:pctThirtySixMonthNetIncomeGrowth>
<web:pctThirtySixMonthEpsGrowth>13.56</web:pctThirtySixMonthEpsGrowth>
<web:pctThirtySixMonthDividendGrowth>13.56</web:pctThirtySixMonthDividendGrowth>
</web:marketMedian>
</web:growthComparison>
</web:return>
</web:GetCompanyComparisonDataResponse>
</soapenv:Body>
</soapenv:Envelope>
8.3 Company Market Data
8.3.1 Overview
This call returns financial market data for a given company id.
8.3.2 Input Parameters
| Field Name |
Required |
Value |
Notes |
| uniqueId |
Yes |
Company DUNS Number or Hoovers Company ID |
|
8.3.3 Sample XML Request
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:web="http://webservice.hoovers.com">
<soapenv:Header>
<web:API-KEY>Your API Key HERE</web:API-KEY>
</soapenv:Header>
<soapenv:Body>
<web:GetCompanyMarketDataRequest>
<web:uniqueId>13193114315195</web:uniqueId>
</web:GetCompanyMarketDataRequest>
</soapenv:Body>
</soapenv:Envelope>
8.3.4 Output Parameters
| Element Name |
Type |
Notes |
| return/currentInformation/lastCloseDate |
date |
Date of the reported last close price. |
| return/currentInformation/lastCloseAmount |
decimal |
The reported last close price. |
| return/currentInformation/fiftyTwoWeekHigh |
decimal |
The fifty two week stock price high. |
| return/currentInformation/fiftyTwoWeekLow |
decimal |
The fifty two week stock price low. |
| return/currentInformation/sixtyMonthBeta |
decimal |
The sixty month beta. |
| return/currentInformation/marketCap |
decimal |
The market cap for the company in millions. |
| return/currentInformation/sharesOutstanding |
long |
The shares outstanding for the company in millions. |
| return/currentInformation/dividendRate |
decimal |
The dividend rate for the company. |
| return/currentInformation/dividendYield |
decimal |
The dividend yield for the company. |
| return/currentInformation/numOfInstitutionalHolders |
long |
The number of institutions owning this companies stock. |
| return/currentInformation/latestShortInterestRatio |
decimal |
The short interest ratio for this company. |
| return/currentInformation/priceSalesRatio |
decimal |
Price to sales ratio. |
| return/currentInformation/priceBookRatio |
decimal |
Price to book ratio. |
| return/currentInformation/priceEarningsRatio |
decimal |
Price to earnings ratio. |
| return/currentInformation/priceCashFlowRatio |
decimal |
Price to cash flow ratio. |
| return/currentInformation/pctReturnOnAssets |
decimal |
Return on assets as a percentage. |
| return/currentInformation/pctReturnOnEquity |
decimal |
Return on equity as a percentage. |
| return/currentInformation/currentRatio |
decimal |
Current ratio for this company. |
| return/currentInformation/longTermDebtToEquity |
decimal |
Long term debt to equity ratio for this company. |
| return/currentInformation/pctOwnedByInstitutions |
decimal |
Percentage of the company stock owned by institutions. |
| return/currentInformation/latestNetInsiderTransactions |
decimal |
The amount of recent insider transactions. |
| return/growthRates/[twelveMonth OR thirtySixMonth OR sixtyMonth]/pctRevenueGrowth |
decimal |
Percentage of revenue growth for 12, 36, and 60 months respectively. |
| return/growthRates/[twelveMonth OR thirtySixMonth OR sixtyMonth]/pctEpsGrowth |
decimal |
Percentage of EPS growth for 12, 36, and 60 months respectively. |
| return/growthRates/[twelveMonth OR thirtySixMonth OR sixtyMonth]/pctDividendGrowth |
long |
Percentage of dividend growth for 12, 36, and 60 months respectively. |
8.3.5 Sample XML Response
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Body>
<web:GetCompanyMarketDataResponse xmlns:web="http://webservice.hoovers.com">
<web:return>
<web:currentInformation>
<web:lastCloseDate>2009-04-15-05:00</web:lastCloseDate>
<web:lastCloseAmount>7.4</web:lastCloseAmount>
<web:fiftyTwoWeekHigh>19.99</web:fiftyTwoWeekHigh>
<web:fiftyTwoWeekLow>3.24</web:fiftyTwoWeekLow>
<web:sixtyMonthBeta>1.72</web:sixtyMonthBeta>
<web:marketCap>336.05</web:marketCap>
<web:sharesOutstanding>45412</web:sharesOutstanding>
<web:dividendRate>0.48</web:dividendRate>
<web:dividendYield>0.02</web:dividendYield>
<web:numOfInstitutionalHolders>39</web:numOfInstitutionalHolders>
<web:latestShortInterestRatio>11.30</web:latestShortInterestRatio>
<web:priceSalesRatio>4.94</web:priceSalesRatio>
<web:priceBookRatio>1.88</web:priceBookRatio>
<web:priceEarningsRatio>-0.45</web:priceEarningsRatio>
<web:priceCashFlowRatio>0.33</web:priceCashFlowRatio>
<web:pctReturnOnAssets>-9.25</web:pctReturnOnAssets>
<web:pctReturnOnEquity>-19.51</web:pctReturnOnEquity>
<web:currentRatio>0.00</web:currentRatio>
<web:longTermDebtToEquity>0.00</web:longTermDebtToEquity>
<web:pctOwnedByInstitutions>0.47</web:pctOwnedByInstitutions>
<web:latestNetInsiderTransactions>0</web:latestNetInsiderTransactions>
</web:currentInformation>
<web:growthRates>
<web:twelveMonth>
<web:pctRevenueGrowth>0.00</web:pctRevenueGrowth>
<web:pctEpsGrowth>10.44</web:pctEpsGrowth>
<web:pctDividendGrowth>-21.45</web:pctDividendGrowth>
</web:twelveMonth>
<web:thirtySixMonth>
<web:pctRevenueGrowth>0.00</web:pctRevenueGrowth>
<web:pctEpsGrowth>13.55</web:pctEpsGrowth>
<web:pctDividendGrowth>41.43</web:pctDividendGrowth>
</web:thirtySixMonth>
<web:sixtyMonth>
<web:pctRevenueGrowth>0.00</web:pctRevenueGrowth>
<web:pctEpsGrowth>21.40</web:pctEpsGrowth>
<web:pctDividendGrowth>45.93</web:pctDividendGrowth>
</web:sixtyMonth>
</web:growthRates>
</web:return>
</web:GetCompanyMarketDataResponse>
</soapenv:Body>
</soapenv:Envelope>
