Hoover's API Version 3.4 - Industry

Queries - SOAP - Industry Information

IMPORTANT: All calls on this page require an API key

New features are highlighted.

1 Find Industry By Keyword

1.1 Overview

This call returns Industries that match the keyword sent in the request.

1.2 Input Parameters

Required fields are indicated with.

Field Name Value Notes
keyword String containing a keyword or phrase  
orderBy Order By Values defined in WSDL. Valid values are IndustryName, HooversIndustryCode
sortDirection Sort Direction Values defined in WSDL: sortDirectionTypes - Ascending or Descending
premiumIndustryOnly Boolean field, defaults to false Indicator to return only Hoover's Industries that have a valid mapping to First Research industries

1.3 Output Parameters

Field Name Value Notes
/return/resultSet Collection of Hit elements.  
/return/resultSet/hit Container element for search result data.  
/return/resultSet/hit/industryResult Container element for industry search result data.  
/return/resultSet/hit/industryResult/hooversIndustryCode HIC  
/return/resultSet/hit/industryResult/industryName Industry Name  
/return/resultSet/hit/industryResult/shortOverview Short Overview  

2 Get Call Prep Sheet

2.1 Overview

This call returns useful First Research industry information to assist in preparation for calling a client in a certain industry (given a Hoover's Industry Code)

2.2 Input Parameters

Required fields are indicated with.

Field Name Value Notes
hooversIndustryCode Hoover's Industry Code (HIC) Previously, this call required a First Research industry code (profileId). We now require HICs.

2.3 Output Parameters

Field Name Value Notes
/return/hooversIndustryCode Hoover's Industry Code (HIC)  
/return/industryName Industry Name  
/return/keyBusinessChallenges Collection of challenge elements  
/return/keyBusinessChallenges/challenge Challenge element  
/return/keyBusinessChallenges/challenge/title Challenge title  
/return/keyBusinessChallenges/challenge/description Challenge description  
/return/keyBusinessChallenges/challenge/question Challenge question  
/return/keyBusinessChallenges/challenge/orderNumber Sort Order Number of the challenge  
/return/keyBusinessOpportunities Collection of opportunity elements  
/return/keyBusinessOpportunities/opportunity Opportunity element  
/return/keyBusinessOpportunities/opportunity/title Opportunity title  
/return/keyBusinessOpportunities/opportunity/description Opportunity description  
/return/keyBusinessOpportunities/opportunity/question Opportunity question  
/return/keyBusinessOpportunities/opportunity/orderNumber Sort Order Number of the opportunity  
/return/fastFacts Collection of fact elements  
/return/fastFacts/fastFact Fast fact element  
/return/fastFacts/fastFact/fact Fact  
/return/fastFacts/fastFact/orderNumber Sort Order Number  
/return/executiveTalkingPoints Collection of talkingPoint elements  
/return/executiveTalkingPoints/talkingPoint TalkingPoint elements  
/return/executiveTalkingPoints/talkingPoint/role TalkingPoint Role  
/return/executiveTalkingPoints/talkingPoint/focusIssue TalkingPoint Focus Issue  
/return/executiveTalkingPoints/talkingPoint/callPrepQuestion TalkingPoint Call Prep Question  
/return/executiveTalkingPoints/talkingPoint/orderNumber Sort Order Number  

3 Advanced Industry Search

3.1 Overview

This call returns Industries that match the criteria sent in the request.

3.2 Input Parameters

Required fields are indicated with.

Field Name Value Notes
nAICS NAICS code 2 to 6 digits
uSSIC USSIC code 2 to 8 digits
uKSIC UKSIC code 2 to 5 digits
orderBy Order By Values defined in WSDL. Valid values are IndustryName, HooversIndustryCode
sortDirection Sort Direction Values defined in WSDL: sortDirectionTypes - Ascending or Descending

3.3 Output Parameters

Field Name Value Notes
/return/resultSet Collection of Hit elements.  
/return/resultSet/hit Container element for search result data.  
/return/resultSet/hit/industryResult Container element for industry search result data.  
/return/resultSet/hit/industryResult/hooversIndustryCode HIC  
/return/resultSet/hit/industryResult/industryName Industry Name  
/return/resultSet/hit/industryResult/shortOverview Short Overview  

4 Get Industry

4.1 Overview

This call returns Hoover's and First Research industry information for an Hoover's Industry Code.

4.2 Input Parameters

Required fields are indicated with.

Field Name Value Notes
hooversIndustryCode Hoover's Industry Code (HIC)  
chapters/chapterName Values defined in WSDL: ChapterName Relevant chapter names are:
  • All (returns all the chapters)
  • IndustryOverview
  • QuarterlyIndustryUpdate
  • BusinessChallenges
  • TrendsAndOpportunities
  • ExecutiveInsight
  • CallPreparationQuestions
  • FinancialInformation
  • IndustryForecast
  • IndustryWebsites
  • GlossaryOfAcronyms
  • IndustryIndicators

4.3 Output Parameters

Field Name Value Notes
/return/hooversIndustryCode Hoover's Industry Code (HIC)  
/return/industryName Industry Name  
/return/industryDescription Industry Description  
/return/ussicCodes Container element for US SIC Codes  
/return/ussicCodes/ussic US SIC Code element There can be multiple of these elements
/return/naicsCodes Container element for NAICS Codes  
/return/naicsCodes/naics NAICS Code element There can be multiple of these elements
/return/uksicCodes Container element for UK SIC Codes  
/return/uksicCodes/uksic UK SIC Code element There can be multiple of these elements
/return/relatedIndustries Container element for Related Industries  
/return/relatedIndustries/relatedIndustry Container element for each Related Industry There can be multiple of these elements
/return/relatedIndustries/relatedIndustry/hooversIndustryCode Hoover's Industry Code for the Related Industry  
/return/relatedIndustries/relatedIndustry/industryName Name of the Related Industry  
/return/chapters Container element for Industry Chapters  
/return/chapters/chapter Container element for each Chapter There can be multiple of these elements
/return/chapters/chapter/chapterName Name of the chapter  
/return/chapters/chapter/paragraphs Container element for Chapter Paragraphs  
/return/chapters/chapter/paragraphs/paragraph Container element for a paragraph within the chapter There can be multiple of these elements
/return/chapters/chapter/paragraphs/paragraph/title Paragraph title  
/return/chapters/chapter/paragraphs/paragraph/contents Paragraph contents  
/return/chapters/chapter/paragraphs/paragraph/siteUrl Paragraph Site URL  
/return/chapters/chapter/paragraphs/paragraph/imageUrl Paragraph Image URL  
/return/chapters/chapter/paragraphs/paragraph/orderNumber Sort Order Number of the Paragraph Paragraphs are displayed in an ascending order based on orderNumber
/return/chapters/chapter/paragraphs/paragraph/bullets Container element for Paragraph Bullets  
/return/chapters/chapter/paragraphs/paragraph/bullets/bullet Paragraph Bullet There can be multiple of these elements
/return/chapters/chapter/subChapters Container element for Sub-Chapters  
/return/chapters/chapter/subChapters/chapter A Sub-Chapter The content of this element matches /return/chapters/chapter except that it does not contain any subChapters.

5 Get Industry for State or Province

5.1 Overview

This call returns a First Research Profile for one of the United States of America or a Canadian Province. Some data returned may be encoded HTML.

5.2 Input Parameters

Required fields are indicated with.

Field Name Value Notes
stateId A two letter abbreviation for a state Note: Either stateId or provinceId is required. Do not use both.
provinceId A two letter abbreviation for a province Note: Either stateId or provinceId is required. Do not use both.

5.3 Output Parameters

Field Name Value Notes
/return/stateProvinceProfile/id The state or province abbreviation  
/return/stateProvinceProfile/name The state or province name  
/return/stateProvinceProfile/imageUrl A URL where an image representing the state or province can be downloaded.  
/return/stateProvinceProfile/chapters A list of chapters containing industry information for the state  
/return/stateProvinceProfile/chapters/chapter/name The name of the current chapter  
/return/stateProvinceProfile/chapters/chapter/paragraphs A list of paragraphs for the current chapter  
/return/stateProvinceProfile/chapters/chapter/paragraphs/paragraph/title The title for the current paragraph element  
/return/stateProvinceProfile/chapters/chapter/paragraphs/paragraph/contents The contents of the current paragraph  
/return/stateProvinceProfile/chapters/chapter/paragraphs/paragraph/siteUrl A website URL that goes with the current paragraph.  
/return/stateProvinceProfile/chapters/chapter/paragraphs/paragraph/imageUrl An image URL that goes with the current paragraph  
/return/stateProvinceProfile/chapters/chapter/paragraphs/paragraph/orderNumber The relative sort order number of the current paragraph.  
/return/stateProvinceProfile/chapters/chapter/paragraphs/paragraph/bullets A list of bullet points that go with the current paragraph  
/return/stateProvinceProfile/chapters/chapter/paragraphs/paragraph/bullets/bullet An instance of a bullet that goes with the current paragraph  
/return/relatedIndustries A list of relatedIndustry elements containing industries related to the state or province  
/return/relatedIndustries/relatedIndustry/hooversIndustryCode The Hoover's Industry Code for the related industry  
/return/relatedIndustries/relatedIndustry/industryName The industry name for the related industry  

6 Get Hoover's Industry

6.1 Overview

This call returns Hoover's Industry information for given Hoover's Industry Code. This call does not return First Research information.

6.2 Input Parameters

Required fields are indicated with.

Field Name Value Notes
hooversIndustryCode Hoover's Industry Code (HIC)  

6.3 Output Parameters

Field Name Value Notes
/return/hooversIndustryCode Hoover's Industry Code (HIC)  
/return/industryName Industry Name  
/return/industryDescription Industry Description  
/return/ussicCodes Container element for US SIC Codes  
/return/ussicCodes/ussic US SIC Code element There can be multiple of these elements
/return/naicsCodes Container element for NAICS Codes  
/return/naicsCodes/naics NAICS Code element There can be multiple of these elements
/return/uksicCodes Container element for UK SIC Codes  
/return/uksicCodes/uksic UK SIC Code element There can be multiple of these elements
/return/relatedIndustries Container element for Related Industries All the Hoover's industries related to this industry code
/return/relatedIndustries/relatedIndustry Container element for each Related Industry There can be multiple of these elements
/return/relatedIndustries/relatedIndustry/hooversIndustryCode Hoover's Industry Code for the Related Industry  
/return/relatedIndustries/relatedIndustry/industryName Name of the Related Industry