API Documentation

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
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>&lt; $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 &amp; 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>