Hoover's API Version 3.3 - Person

Queries - SOAP - Person Information

IMPORTANT: All calls on this page require an API key

New features are highlighted.

1 Find Person By Keyword Search

1.1 Overview

Returns search result of people based on keyword. The keyword should be a person's name or part of a name.

1.2 Input Parameters

Required fields are indicated with.

Field Name Value Notes
keyword String containing a keyword. Keyword should be a name of a person or part of a name  
maxRecords Between 1-200. Default = 20  
hitOffset Greater than or equal to 0 but less than or equal to 10,000. Default = 0 Paging support, the firstHit returned will be hitOffset + 1. hitOffset is now zero-based.
sortDirection Values defined in WSDL: sortDirectionTypes - Ascending or Descending This has no effect without a valid orderBy.
orderBy Values defined in WSDL, orderByTypes Default order by is relevance. Other values for this search include:
  • CompanyName
  • CompanyType
  • CountryName
  • CityName
  • StateName
  • PhoneNumber
  • FaxNumber
  • SalesGrowth12Mon
  • TotalAssets
  • SalesUS
  • EmployeesTotal
  • EmployeesHere
  • FiscalYearEndMonth
  • MarketCap
  • NetIncomeGrowth12Mon
  • EmployeeGrowth12Mon
  • ROE
  • ROA
  • EarningsComparison
  • BookValueComparison
  • NetIncome
  • PersonFirstName
  • PersonLastName
  • PersonTitle
returnSearchNavigation 'true' or 'false' If true navigators will be returned in the response to enable drill down into search results
\searchNavigation\ jobFunctionSearchNavigation\ jobFunctionSearchNavigationValue A job function navigation link which can be fed back into other calls. The job function navigation link must be used to drill down by number of people with that job.
\searchNavigation\ locationSearchNavigation\ countryNavigation\ countryNavigationValue A country navigation link which can be fed back into other calls. The country navigation link must be used to drill down by country.
\searchNavigation\ locationSearchNavigation\ countryNavigation\ stateNavigation\ stateNavigationValue A state/province navigation link which can be fed back into other calls. The state/province navigation link must be used to drill down by state/province.
\searchNavigation\ locationSearchNavigation\ countryNavigation\ stateNavigation\ cityNavigation\ cityNavigationValue A city navigation link which can be fed back into other calls. The city navigation link must be used to drill down by city.
searchNavigation/ industrySearchNavigation/ industrySearchNavigationValue A industry navigation link which can be fed back into other calls. The industry navigation link must be used to drill down by industry.
searchNavigation/ industrySearchNavigation/ ussicSearchNavigationValue A UsSIC navigation link which can be fed back into other calls. The UsSIC navigation link must be used to drill down by UsSIC.
searchNavigation/ industrySearchNavigation/ naicsSearchNavigationValue A NaICS navigation link which can be fed back into other calls. The NaICS navigation link must be used to drill down by NaICS.

1.3 Output Parameters

Field Name Value Notes
\return\resultSet\firstHit First Hit
\return\resultSet\hit\coOfficialResults\coOfficialId Hoovers Official ID
\return\resultSet\hit\coOfficialResults\companyId Hoovers Company ID
\return\resultSet\hit\coOfficialResults\duns DUNS  
\return\resultSet\hit\coOfficialResults\firstName Person First Name
\return\resultSet\hit\coOfficialResults\lastName Person Last Name
\return\resultSet\hit\coOfficialResults\middleName Person Middle Name
\return\resultSet\hit\coOfficialResults\suffix Person Suffix
\return\resultSet\hit\coOfficialResults\title Person Title
\return\resultSet\hit\coOfficialResults\companyName Company Name
\return\resultSet\hit\coOfficialResults\connectMail Wrapper element for ConnectMail indicators  
\return\resultSet\hit\coOfficialResults\connectMail\connectMailNameSource Indicates if official's name is a ConnectMail contact  
\return\resultSet\hit\coOfficialResults\connectMail\connectMailEmailSource Indicates if official's email is a ConnectMail contact  
\return\resultSet\hit\coOfficialResults\connectMail\connectMailPhoneSource Indicates if official's phone number is a ConnectMail contact  
\return\resultSet\hit\hitNumber Hit Number
\return\resultSet\hits Total Number of Hits in this Response  
\return\resultSet\lastHit Last Hit
\return\resultSet\totalHits Aggregate Total Number of Hits This is the total number of results the search returned
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\jobFunctionNavigators\jobFunctionNavigator\jobFunctionNavigatorValue The value of a navigation link for job functions To drill down on job functions a value from this element must be fed back into another call with the same keyword.
\return\navigators\jobFunctionNavigators\jobFunctionNavigator\jobFunctionNavigatorDescription The description of a navigation link for job functions Could be used as a display value for the link
\return\navigators\locationNavigators\countryNavigators\countryNavigator\countryNavigatorValue The value of a navigation link for country To drill down on country a value from this element must be fed back into another call with the same keyword.
\return\navigators\locationNavigators\countryNavigators\countryNavigator\countryNavigatorDescription The description of a navigation link for country description Could be used as a display value for the link
\return\navigators\locationNavigators\countryNavigators\countryNavigator\stateProvinceNavigators\stateProvinceNavigator\stateProvinceNavigatorValue The value of a navigation link for state/province To drill down on state/province a value from this element must be fed back into another call with the same keyword.
\return\navigators\locationNavigators\countryNavigators\countryNavigator\stateProvinceNavigators\stateProvinceNavigator\stateProvinceNavigatorDescription The description of a navigation link for state/province description Could be used as a display value for the link
\return\navigators\locationNavigators\countryNavigators\countryNavigator\stateProvinceNavigators\stateProvinceNavigator\cityNavigators\cityNavigator\cityNavigatorValue The value of a navigation link for city To drill down on city a value from this element must be fed back into another call with the same keyword.
\return\navigators\locationNavigators\countryNavigators\countryNavigator\stateProvinceNavigators\stateProvinceNavigator\cityNavigators\cityNavigator\cityNavigatorDescription The description of a navigation link for city description Could be used as a display value for the link
\return\navigators\industryNavigators\industryNavigator\industryNavigatorValue The value of a navigation link for industry To drill down on industry a value from this element must be fed back into another call with the same keyword.
\return\navigators\industryNavigators\industryNavigator\industryNavigatorDescription The description of a navigation link for industry Could be used as a display value for the link
\return\navigators\industryNavigators\ussicNavigator\ussicNavigatorValue The value of a navigation link for UsSIC To drill down on UsSIC a value from this element must be fed back into another call with the same keyword.
\return\navigators\industryNavigators\ussicNavigator\ussicNavigatorDescription The description of a navigation link for UsSIC Could be used as a display value for the link
\return\navigators\industryNavigators\naicsNavigator\naicsNavigatorValue The value of a navigation link for NaICS To drill down on NaICS a value from this element must be fed back into another call with the same keyword.
\return\navigators\industryNavigators\naicsNavigator\naicsNavigatorDescription The description of a navigation link for NaICS Could be used as a display value for the link

2 Advanced Person Search

2.1 Overview

Returns search result of people based on various different criteria

2.2 Input Parameters

Required fields are indicated with.

Field Name Value Notes
\bal\maxrecords Max Records Between 1-200. Default = 20
\bal\hitOffset Greater than or equal to 0 but less than or equal to 10,000. Default = 0 Paging support, the firstHit returned will be hitOffset + 1. hitOffset is now zero-based.
\bal\sortdirection Sort Direction Values defined in WSDL: SortDirectionTypes - Ascending or Descending
\bal\orderby Order By Values defined in WSDL, BaseOrderByTypes
\bal\companySize\employeesFrom Total Employees Lower Bound
\bal\companySize\employeesTo Total Employees Upper Bound
\bal\companySize\employeesGrowthFrom Total Employees Growth Percentage Lower Bound
\bal\companySize\employeesGrowthTo Total Employees Growth Percentage Upper Bound
\bal\companySize\employeesThisLocationFrom Employees at this Location Lower Bound
\bal\companySize\employeesThisLocationTo Employees at this Location Upper Bound
\bal\companySize\marketCapFrom Market Cap ($ mil) Lower Bound
\bal\companySize\marketCapTo Market Cap ($ mil) Upper Bound
\bal\companySize\salesFrom Annual Sales ($ mil) Lower Bound
\bal\companySize\salesTo Annual Sales ($ mil) Upper Bound
\bal\companySize\salesGrowthFrom Annual Sales Growth (%) Lower Bound
\bal\companySize\salesGrowthTo Annual Sales Growth (%) Upper Bound
\bal\companyType\location Location Type ID Value from GetAdvancedSearchLookups
\bal\companyType\ownershipType Values are 1 (Public), 21 (Owned by a Public Company) or 0 (Non-Public)..
\bal\companyType\subsidiaryStatus Subsidiary Status Subsidiary or Not a Subsidiary
\bal\financialdata\advertisingExpenseFrom Ad Expense ($ mil) Lower Bound.
\bal\financialdata\advertisingExpenseTo Ad Expense ($ mil) Upper Bound.
\bal\financialdata\assetsFrom Assets ($ mil) Lower Bound.  
\bal\financialdata\assetsTo Assets ($ mil) Upper Bound.  
\bal\financialdata\filingDateFrom Filing Date Lower Bound MM/DD/YYYY
\bal\financialdata\filingDateTo Filing Date Upper Bound MM/DD/YYYY
\bal\financialdata\fiscalYearEnd Fiscal Year End Month  
\bal\financialdata\incomeFrom Net Income ($ mil) Lower Bound.  
\bal\financialdata\incomeGrowthFrom Net Income Growth (%) Lower Bound  
\bal\financialdata\incomeGrowthTo Net Income Growth (%) Upper Bound  
\bal\financialdata\incomeTo Net Income ($ mil) Upper Bound  
\bal\financialdata\offerFrom US IPO Data - Offer Amount ($ mil.) Lower Bound  
\bal\financialdata\offerTo US IPO Data - Offer Amount ($ mil.) Upper Bound  
\bal\financialdata\priceRangeFrom US IPO Data - Price Range ($) Lower Bound  
\bal\financialdata\priceRangeTo US IPO Data - Price Range ($) Upper Bound  
\bal\financialdata\researchExpenseFrom R&D Expense ($ mil) Lower Bound  
\bal\financialdata\researchExpenseTo R&D Expense ($ mil) Upper Bound  
\bal\financialdata\tradingDateFrom Trading Date Lower Bound MM/DD/YYYY
\bal\financialdata\tradingDateTo Trading Date Upper Bound MM/DD/YYYY
\bal\financialdata\underwriterId Underwriters ID Value from GetAdvancedSearchLookups It searches only the lead underwriter for the given underwriterId.
\bal\industry\hooversIndustryCode Hoovers Industry Name ID Value from GetAdvancedSearchLookups
\bal\industry\primaryOnly Primary Industry Only Boolean
\bal\industry\nAICS NAICS Code Enter only one code per element. Use multiple elements for multiple codes. Enter at least two digits per code. No CSV or Ranges can be specified
\bal\industry\nAICSRange\[from|to] NAICS Code Ranges Enter one or more range elements. Each range element must contain 'from' and a 'to' element.
\bal\industry\uSSIC US SIC Code Enter only one code per element. Use multiple elements for multiple codes. Enter at least two digits per code. No CSV or Ranges can be specified
\bal\industry\uSSICRange\[from|to] SIC Code Ranges Enter one or more range elements. Each range element must contain 'from' and a 'to' element.
\bal\industry\uKSIC UK SIC Code Enter only one code per element. Use multiple elements for multiple codes. Enter at least two digits per code. No CSV or Ranges can be specified
\bal\industry\uKSICRange\[from|to] UKSIC Code Ranges Enter one or more range elements. Each range element must contain 'from' and a 'to' element.
\bal\location\areacode US/Canada Area Code e.g. 512 or 210, 512, 212
\bal\location\streetAddress Street Address e.g. 1700 Pennsylvania Ave.
\bal\location\county Wrapper for county type Searching by multiple counties is allowed, send in multiple county wrapper elements
\bal\location\county\countyId County ID ID Value from GetAdvancedSearchLookups
\bal\location\county\state State ID Value from GetAdvancedSearchLookups
\bal\location\county\countryId Country ID ID Value from GetAdvancedSearchLookups
\bal\location\city City e.g. Madrid or New York (single city only)
\bal\location\countryId Country ID Value from GetAdvancedSearchLookups
\bal\location\globalState Global State/Province e.g Queensland or NY (single province/state only)
\bal\location\metropolitanId US Metropolitan Area ID Value from GetAdvancedSearchLookups
\bal\location\regionId World Region ID Value from GetAdvancedSearchLookups
\bal\location\usStateCanadaProvince US State/Canada Province  
\bal\location\postalCode Postal Code e.g. 78701 or "SW1P 1JA" or "SW1" or Separate multiple ZIP codes by commas.
\bal\usZipCodeRange\from US ZIP Code Lower Bound  
\bal\usZipCodeRange\to US ZIP Code Upper Bound  
\bal\location\zipAreaSearch\scale Units to search in: miles or kilometers e.g. Find results within 50 miles of 78745 (up to a maximum radius of 100 miles or 160 km). Use only one 5-digit ZIP code. Requires zipareawithin and zipareazipcode.
\bal\location\zipAreaSearch\radius # of miles or kilometers to search within. e.g. Find results within 50 miles of 78745 (up to a maximum radius of 100 miles or 160 km). Use only one 5-digit ZIP code. Requires zipareawithin and zipareazipcode.
\bal\location\zipAreaSearch\zipCode Zipcode to search within (78745 in the example) e.g. Find results within 50 miles of 78745 (up to a maximum radius of 100 miles or 160 km). Use only one 5-digit ZIP code. Requires zipareawithin and zipareazipcode.
\bal\location\latLongSearch\scale Units to search in: miles or kilometers Requires radius, latitude, and longitude.
\bal\location\latLongSearch\radius # of miles or kilometers to search within. Requires scale, latitude, and longitude.
\bal\location\latLongSearch\latitude latitude Requires scale, radius, and longitude.
\bal\location\latLongSearch\longitude longitude Requires scale, radius, and latitude.
\bal\location\allAny All or Any Matches on Location Criteria Matching ALL means a company would have to match each type of criteria entered. Matching ANY means that a company could match any single type of criteria entered. Valid values All or Any
\bal\location\ukCounty UK County A valid UK County name
\bal\specialtyCriteria\auditorId Auditors ID Value from GetAdvancedSearchLookups
\bal\specialtyCriteria\companyKeyword Company Keyword e.g. laptops or China or acquired, merged, takeover
\bal\specialtyCriteria\duns DUNS Number the duns number must not be more than 9 digits
\bal\specialtyCriteria\exchangeId Exchange ID Value from GetAdvancedSearchLookups
\bal\specialtyCriteria\rankingId Rankings/Indices ID Value from GetAdvancedSearchLookups
\bal\specialtyCriteria\ukRegistration UK Registration Number e.g. 3443456 Use multiple elements for multiple UK Registration values
\bal\specialtyCriteria\ukVat UK Vat Number e.g. 906565610 Use multiple elements for multiple UK VAT values
\bal\specialtyCriteria\yearFoundingFrom Year of Founding or Change in Control Lower Bound YYYY
\bal\specialtyCriteria\yearFoundingTo Year of Founding or Change in Control (YYYY) Upper Bound YYYY
\bal\specialtyCriteria\ultimateParentDuns The ultimate parent DUNS number for a family of companies eg. 060902413 or 884364530
\bal\specialtyCriteria\primaryUrl Primary URL  
\bal\specialtyCriteria\companyName Company Name  
\bal\specialtyCriteria\minorityOwned Minority Owned Company Boolean
\bal\specialtyCriteria\womenOwned Women Owned Company Boolean
\bal\specialtyCriteria\squareFootageFrom Company square foot range from
\bal\specialtyCriteria\squareFootRangeTo Company square foot range to
\bal\specialtyCriteria\ethnicity Ethnicity of the company owner Values defined in WSDL - Ethnicity enumeration
\bal\specialtyCriteria\legalStatus Legal Status of the company Values defined in WSDL - Legal Status enumeration
\bal\specialtyCriteria\ownedOrRented Company resides in Owned or Rented Space Values defined in WSDL - OwnsOrRent enumeration
\bal\people\ageFrom Person Age Lower Bound  
\bal\people\ageTo Person Age Upper Bound  
\bal\people\bonusFrom Person Bonus ($) Lower Bound  
\bal\people\bonusTo Person Bonus ($) Upper Bound  
\bal\people\jobFunctionId Person Job Function ID ID Value from GetAdvancedSearchLookups.
\bal\people\keywordsIn Keywords In Title or Bio
\bal\people\keywordSelect Person Keyword e.g. marketing or Harvard or ad sales
\bal\people\salaryFrom Person Salary ($) Lower Bound  
\bal\people\salaryTo Person Salary ($) Upper Bound  
\bal\people\totalPayFrom Person Total Pay ($) Lower Bound  
\bal\people\totalPayTo Person Total Pay ($) Upper Bound  

2.3 Output Parameters

Field Name Value Notes
\return\people\firstHit First Hit
\return\people\hit\coOfficialResults\coOfficialId Hoovers Official ID
\return\people\hit\coOfficialResults\companyId Hoovers Company ID
\return\people\hit\coOfficialResults\duns DUNS  
\return\people\hit\coOfficialResults\firstName Person First Name
\return\people\hit\coOfficialResults\lastName Person Last Name
\return\people\hit\coOfficialResults\middleName Person Middle Name
\return\people\hit\coOfficialResults\suffix Person Suffix
\return\people\hit\coOfficialResults\title Person Title
\return\people\hit\coOfficialResults\companyName Company Name
\return\resultSet\hit\coOfficialResults\connectMail Wrapper element for ConnectMail indicators  
\return\resultSet\hit\coOfficialResults\connectMail\connectMailNameSource Indicates if official's name is a ConnectMail contact  
\return\resultSet\hit\coOfficialResults\connectMail\connectMailEmailSource Indicates if official's email is a ConnectMail contact  
\return\resultSet\hit\coOfficialResults\connectMail\connectMailPhoneSource Indicates if official's phone number is a ConnectMail contact  
\return\people\hit\hitNumber Hit Number
\return\people\hits Total Number of Hits in this Response  
\return\people\lastHit Last Hit
\return\people\totalHits Aggregate Total Number of Hits This is the total number of results the search returned

3 Get Person Detail

3.1 Overview

Returns search result of detailed person information based on criteria of a Hoover's Official ID and Company ID.

When calling this service, ensure the Hoover's Official 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 Official ID will cause either invalid or no results.

3.2 Input Parameters

Required fields are indicated with.

Field Name Value Notes
coOfficialId Hoovers Official ID
uniqueCompanyId Hoover's Company ID or DUNS  
connectMail True or False; defaults to False Optional flag set to 'True' when requesting ConnectMail data.
convertCurrencyTo Accepted Values are : USD, CAD, GBP, JPY, EUR, SEK only Specify the currency type in which the results should be in.Defaults to USD

3.3 Output Parameters

Field Name Value Notes
\return\official\companyId Hoovers Company ID
\return\official\duns DUNS number  
\return\official\primaryCompanyPhone Primary phone number for the company  
\return\official\coOfficialId Hoovers Official ID
\return\official\currencyConvertedTo Currency in which the latest salary is returned Can be specified in the request using convertCurrencyTo element
\return\official\biography Biographic Information  
\return\official\biographySource Biography Source Name  
\return\official\contact Official Contact Information Wrapper  
\return\official\contact\phoneNumber Contact phone number from ConnectMail  
\return\official\contact\email Contact email address from ConnectMail  
\return\official\latestPosition Most recent position information
\return\official\latestPosition\title Person Title  
\return\official\latestPosition\titleText Latest position title text  
\return\official\latestPosition\startYear Latest position start year
\return\official\latestPosition\endYear Latest position end year
\return\official\positionHistory Collection on position elements (position history for the official)
\return\official\positionHistory\position\title Person Title  
\return\official\positionHistory\position\titleText Latest position title text  
\return\official\positionHistory\position\startYear Position start year
\return\official\positionHistory\position\endYear Position end year
\return\official\latestSalary Most recent salary information
\return\official\latestSalary\year Latest salary year  
\return\official\latestSalary\salary Salary for the year, excluding bonus  
\return\official\latestSalary\totalSalary Total compensation for the year, including any bonus or other compensation
\return\official\latestSalary\bonus Bonus for the year  
\return\official\salaryHistory Collection of salary elements (salary history for the official)
\return\official\salaryHistory\salary\year Salary Year  
\return\official\salaryHistory\salary\salary Salary for the year excluding bonus  
\return\official\salaryHistory\salary\totalSalary Total compensation including bonus
\return\official\salaryHistory\salary\bonus Bonus for the year  
\return\official\person\fullName Person Full Name  
\return\official\person\lastName Person Last Name  
\return\official\person\firstName Person First Name  
\return\official\person\middleName Person Middle Name  
\return\official\person\suffix Person Suffix  
\return\official\person\prefix Person Prefix  
\return\official\person\age Person Age  
\return\official\connectMail Wrapper element for ConnectMail indicators  
\return\official\connectMail\connectMailNameSource Indicates if official's name is a ConnectMail contact  
\return\official\connectMail\connectMailEmailSource Indicates if official's email is a ConnectMail contact  
\return\official\connectMail\connectMailPhoneSource Indicates if official's phone number is a ConnectMail contact  

4 Get Person Detail Simple

4.1 Overview

Returns a reduced subset of person details for a given Unique Official ID

4.2 Input Parameters

Required fields are indicated with.

Field Name Value Notes
coOfficialId Hoovers Official ID
uniqueCompanyId Hoover's Company ID or DUNS  
connectMail True or False; defaults to False Optional flag set to 'True' when requesting ConnectMail data.
convertCurrencyTo Accepted Values are : USD, CAD, GBP, JPY, EUR, SEK only Specify the currency type in which the results should be in.Defaults to USD

4.3 Output Parameters

Field Name Value Notes
\return\official\coOfficialId Hoovers Official ID
\return\official\currencyConvertedTo Currency in which the latest salary is returned Can be specified in the request using convertCurrencyTo element
\return\official\latestPosition Most recent position information
\return\official\latestPosition\title Person Title  
\return\official\latestPosition\startYear Latest position start year
\return\official\latestPosition\endYear Latest position end year
\return\official\latestSalary Most recent salary information
\return\official\latestSalary\year Latest salary year  
\return\official\latestSalary\salary Salary for the year, excluding bonus  
\return\official\latestSalary\totalSalary Total compensation for the year, including any bonus or other compensation
\return\official\latestSalary\bonus Bonus for the year  
\return\official\person\fullName Person Full Name  
\return\official\person\lastName Person Last Name  
\return\official\person\firstName Person First Name  
\return\official\person\middleName Person Middle Name  
\return\official\person\suffix Person Suffix  
\return\official\person\prefix Person Prefix  
\return\official\person\age Person Age  
\return\official\contact Official Contact Information Wrapper  
\return\official\contact\phoneNumber Contact phone number from ConnectMail  
\return\official\contact\email Contact email address from ConnectMail  
\return\official\connectMail Wrapper element for ConnectMail indicators  
\return\official\connectMail\connectMailNameSource Indicates if official's name is a ConnectMail contact  
\return\official\connectMail\connectMailEmailSource Indicates if official's email is a ConnectMail contact  
\return\official\connectMail\connectMailPhoneSource Indicates if official's phone number is a ConnectMail contact