API Documentation Version 1.7
Current Development Version - Hoover's API Version 1.7
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
The WSDL for Hoover's API can be found at http://hapi-dev.hoovers.com/axis2/services/HooversAPI-1700?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-1700.
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.
.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 | If the query is misspelled, the API will attempt to correct the spelling and return the first result for the corrected spelling |
| 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:
|
| 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>300</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>[500;999]</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>^CA$</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:employeeNavigator>
<web:employeeNavigatorValue>[5;10]</web:employeeNavigatorValue>
<web:employeeNavigatorDescription>5-10 (2)</web:employeeNavigatorDescription>
</web:employeeNavigator>
<web:employeeNavigator>
<web:employeeNavigatorValue>[11;49]</web:employeeNavigatorValue>
<web:employeeNavigatorDescription>11-49 (7)</web:employeeNavigatorDescription>
</web:employeeNavigator>
<web:employeeNavigator>
<web:employeeNavigatorValue>[50;99]</web:employeeNavigatorValue>
<web:employeeNavigatorDescription>50-99 (4)</web:employeeNavigatorDescription>
</web:employeeNavigator>
<web:employeeNavigator>
<web:employeeNavigatorValue>[100;499]</web:employeeNavigatorValue>
<web:employeeNavigatorDescription>100-499 (7)</web:employeeNavigatorDescription>
</web:employeeNavigator>
<web:employeeNavigator>
<web:employeeNavigatorValue>[500;999]</web:employeeNavigatorValue>
<web:employeeNavigatorDescription>500-999 (1)</web:employeeNavigatorDescription>
</web:employeeNavigator>
<web:employeeNavigator>
<web:employeeNavigatorValue>[1000;4999]</web:employeeNavigatorValue>
<web:employeeNavigatorDescription>1000-4999 (3)</web:employeeNavigatorDescription>
</web:employeeNavigator>
<web:employeeNavigator>
<web:employeeNavigatorValue>[5000;]</web:employeeNavigatorValue>
<web:employeeNavigatorDescription>More than 5000 (4)</web:employeeNavigatorDescription>
</web:employeeNavigator>
</web:employeeNavigators>
<web:locationTypeNavigators>
<web:locationTypeNavigator>
<web:locationTypeNavigatorValue>2</web:locationTypeNavigatorValue>
<web:locationTypeNavigatorDescription>Branch (5)</web:locationTypeNavigatorDescription>
</web:locationTypeNavigator>
<web:locationTypeNavigator>
<web:locationTypeNavigatorValue>1</web:locationTypeNavigatorValue>
<web:locationTypeNavigatorDescription>Headquarters (12)</web:locationTypeNavigatorDescription>
</web:locationTypeNavigator>
<web:locationTypeNavigator>
<web:locationTypeNavigatorValue>0</web:locationTypeNavigatorValue>
<web:locationTypeNavigatorDescription>Single Location (32)</web:locationTypeNavigatorDescription>
</web:locationTypeNavigator>
</web:locationTypeNavigators>
<web:companyTypeNavigators>
<web:companyTypeNavigator>
<web:companyTypeNavigatorValue>2</web:companyTypeNavigatorValue>
<web:companyTypeNavigatorDescription>Private (23)</web:companyTypeNavigatorDescription>
</web:companyTypeNavigator>
<web:companyTypeNavigator>
<web:companyTypeNavigatorValue>1</web:companyTypeNavigatorValue>
<web:companyTypeNavigatorDescription>Public (16)</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:salesNavigator>
<web:salesNavigatorValue>[1;5></web:salesNavigatorValue>
<web:salesNavigatorDescription>$1 - $5 million (5)</web:salesNavigatorDescription>
</web:salesNavigator>
<web:salesNavigator>
<web:salesNavigatorValue>[5;10></web:salesNavigatorValue>
<web:salesNavigatorDescription>$5 - $10 million (4)</web:salesNavigatorDescription>
</web:salesNavigator>
<web:salesNavigator>
<web:salesNavigatorValue>[10;50></web:salesNavigatorValue>
<web:salesNavigatorDescription>$10 - $50 million (4)</web:salesNavigatorDescription>
</web:salesNavigator>
<web:salesNavigator>
<web:salesNavigatorValue>[50;500></web:salesNavigatorValue>
<web:salesNavigatorDescription>$50 - $500 million (5)</web:salesNavigatorDescription>
</web:salesNavigator>
<web:salesNavigator>
<web:salesNavigatorValue>[500;1000></web:salesNavigatorValue>
<web:salesNavigatorDescription>$500 - $1000 million (2)</web:salesNavigatorDescription>
</web:salesNavigator>
<web:salesNavigator>
<web:salesNavigatorValue>[1000;10000></web:salesNavigatorValue>
<web:salesNavigatorDescription>$1000 - $10000 million (2)</web:salesNavigatorDescription>
</web:salesNavigator>
<web:salesNavigator>
<web:salesNavigatorValue>[10000;></web:salesNavigatorValue>
<web:salesNavigatorDescription>> $10000 million (3)</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\dnbGlobalLinkage\immediateParent | ||
| \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 | |
| \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 | |
| \return\keyNumbers\advertising | Advertising Expenses for the Year | |
| \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 Get Person Detail 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 this company. | |
| \return\keyFinancials\marketValueInfo\marketValueDate | Date of market valuation. | |
| \return\keyFinancials\marketValueInfo\marketValueCurrency | Currency of market value. | |
| \return\keyFinancials\incomeAssets | Contains income asset information. | |
| \return\keyFinancials\incomeAssets\period | Fiscal Period reporting date. | |
| \return\keyFinancials\incomeAssets\assets | Total assets (in millions) of this company. | |
| \return\keyFinancials\incomeAssets\salesGrowthPercent | Sales growth in percent for this company. | |
| \return\keyFinancials\incomeAssets\netIncome | Net income (in millions) of this company. | |
| \return\keyFinancials\incomeAssets\netIncomeGrowthPercent | Net income growth in percent of this company. | |
| \return\keyFinancials\incomeAssets\currency | Currency used for income asset information. | |
| \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:dnbGlobalLinkage>
<web:immediateParent>41416611241688</web:immediateParent>
</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:familyTreeLink>http://phpqapaid.hoovers.com/subscribe/co/familytree.xhtml?HD=611241688&GD=</web:familyTreeLink>
<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:marketValueCurrency>USD</web:marketValueCurrency>
</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:currency>USD</web:currency>
</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 string type. Values between 1 and -1 should be input in the format '0.x', where 'x' can be repeated n times. (e.g. 0.1, -0.7094) |
| \bal\companysize\employeesgrowthto | No | Total Employees Growth Percentage Upper Bound | This field is a string type. Values between 1 and -1 should be input in the format '0.x', where 'x' can be repeated n times. (e.g. 0.1, -0.7094) |
| \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 string type. Values less than 1 should be input in the format '0.x', where 'x' can be repeated n times. (e.g. 0.1, -0.7094) |
| \bal\companysize\marketcapto | No | Market Cap ($ mil) Upper Bound | This field is a string type. Values less than 1 should be input in the format '0.x', where 'x' can be repeated n times. (e.g. 0.1, -0.7094) |
| \bal\companysize\salesfrom | No | Annual Sales ($ mil) Lower Bound | This field is a string type. Values between 1 and -1 should be input in the format '0.x', where 'x' can be repeated n times. (e.g. 0.1, -0.7094) |
| \bal\companysize\salesgrowthfrom | No | Annual Sales Growth (%) Lower Bound | This field is a string type. Values between 1 and -1 should be input in the format '0.x', where 'x' can be repeated n times. (e.g. 0.1, -0.7094) |
| \bal\companysize\salesgrowthto | No | Annual Sales Growth (%) Upper Bound | This field is a string type. Values between 1 and -1 should be input in the format '0.x', where 'x' can be repeated n times. (e.g. 0.1, -0.7094) |
| \bal\companysize\salesto | No | Annual Sales ($ mil) Upper Bound | This field is a string type. Values between 1 and -1 should be input in the format '0.x', where 'x' can be repeated n times. (e.g. 0.1, -0.7094) |
| \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 | |
| \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 | |
| \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\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\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:people>
<web:ageFrom></web:ageFrom>
<web:ageTo></web:ageTo>
<web:bonusFrom></web:bonusFrom>
<web:bonusTo></web:bonusTo>
<web:jobFunction></web:jobFunction>
<web:keyWordsIn></web:keyWordsIn>
<web:keywordSelect></web:keywordSelect>
<web:salaryFrom></web:salaryFrom>
<web:salaryTo></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: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 basic company information and all children/descendants of a given company id based on criteria of a DUNS or a Hoover's Company ID. This service only returns the company and all of its descendants, it does not include parent information except parent DUNS and ultimate parent DUNS.
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>114315195777</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 |
| \return\currency | Currency Short Name | |
| \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 |
| \return\children\child\currency | Child Currency Short Name | |
| \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:currency>USD</web:currency>
<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:currency xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<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:currency xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<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:currency xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<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:currency>USD</web:currency>
<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:currency>USD</web:currency>
<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>5555555555555</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>
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:
|
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 or a Hoover's Company 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>1443072630</web:uniqueId>
</web:GetPersonDetailRequest>
</soapenv:Body>
</soapenv:Envelope>
5.2.4 Output Parameters
| Field Name | Value | Notes |
| \return\official | Company Officials | 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\co-official\companyId | Hoovers Company ID | |
| \return\official\co-official\biography | Biographic Information | |
| \return\official\co-official\biographySource | Biography Source Name | |
| \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 | |
| \return\official\latest-position\coOfficialId | Hoovers Officer ID | |
| \return\official\latest-position\title | Person Title | |
| \return\official\latest-position\year | Year for which this data is current | |
| \return\official\latest-position\salary | Salary for the year, excluding bonus | |
| \return\official\latest-position\total-salary | Total compensation for the year, including any bonus or other compensation | |
| \return\official\position-history\coOfficialId | Hoovers Officer ID | Note that the latest position will be duplicated in this section and the latest-position section |
| \return\official\position-history\title | Person Title | |
| \return\official\position-history\year | Year for which this data is current | |
| \return\official\position-history\salary | Salary for the year, excluding bonus | |
| \return\official\position-history\total-salary | Total compensation for the year, including any bonus or other compensation |
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:co-official>
<web:company-id>110929044</web:company-id>
<web:biography>Graduated from college. Achieved much. Best president ever.</web:biography>
<web:biographySource>Company Web Site</web:biographySource>
</web:co-official>
<web:latest-position>
<web:co-official-id>1443072630</web:co-official-id>
<web:title>President</web:title>
<web:year>2002</web:year>
<web:salary>191000.0</web:salary>
<web:total-salary>213000.0</web:total-salary>
</web:latest-position>
<web:position-history>
<web:co-official-id>1443072630</web:co-official-id>
<web:title>President</web:title>
<web:year>2002</web:year>
<web:salary>191000.0</web:salary>
<web:total-salary>213000.0</web:total-salary>
</web:position-history>
<web:position-history>
<web:co-official-id>1443072630</web:co-official-id>
<web:title>Vice President</web:title>
<web:year>2001</web:year>
<web:salary>150000.0</web:salary>
<web:total-salary>175000.0</web:total-salary>
</web:position-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 string type. Values between 1 and -1 should be input in the format '0.x', where 'x' can be repeated n times. (e.g. 0.1, -0.7094) |
| \bal\companysize\employeesgrowthto | No | Total Employees Growth Percentage Upper Bound | This field is a string type. Values between 1 and -1 should be input in the format '0.x', where 'x' can be repeated n times. (e.g. 0.1, -0.7094) |
| \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 string type. Values less than 1 should be input in the format '0.x', where 'x' can be repeated n times. (e.g. 0.1, -0.7094) |
| \bal\companysize\marketcapto | No | Market Cap ($ mil) Upper Bound | This field is a string type. Values less than 1 should be input in the format '0.x', where 'x' can be repeated n times. (e.g. 0.1, -0.7094) |
| \bal\companysize\salesfrom | No | Annual Sales ($ mil) Lower Bound | This field is a string type. Values between 1 and -1 should be input in the format '0.x', where 'x' can be repeated n times. (e.g. 0.1, -0.7094) |
| \bal\companysize\salesgrowthfrom | No | Annual Sales Growth (%) Lower Bound | This field is a string type. Values between 1 and -1 should be input in the format '0.x', where 'x' can be repeated n times. (e.g. 0.1, -0.7094) |
| \bal\companysize\salesgrowthto | No | Annual Sales Growth (%) Upper Bound | This field is a string type. Values between 1 and -1 should be input in the format '0.x', where 'x' can be repeated n times. (e.g. 0.1, -0.7094) |
| \bal\companysize\salesto | No | Annual Sales ($ mil) Upper Bound | This field is a string type. Values between 1 and -1 should be input in the format '0.x', where 'x' can be repeated n times. (e.g. 0.1, -0.7094) |
| \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\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>
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>
- 1. API Overview
- 2. Authentication
- 3. Hoover's API Support
- 4. Queries - Company Information
- 5. Queries - Person Information
- 6. Query - Lookup Information
