Hoover's API Version 3.2 - Industry
Queries - 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:
|
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 US and Canadian state/provinces . 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 |
- Versions
- Version 3.0
- Version 3.1
- Version 3.2
- Version 3.3
- Version 3.4
- Version 4.0
- Version 3.2 Documentation
- Overview
- Security
- Queries - Company Information
- Queries - Person Information
- Queries - Industry Information
- Queries - Lookup Information
- Queries - Personalization
- Queries - Industry Information