Search industries

Request

Search the industry taxonomy crosswalk across HG industry (23 buckets), NAICS 2012 (~2,200 codes), and SIC 1987 (~1,500 codes).

Supports free-text search, exact code lookup, taxonomy scoping, colloquial alias expansion (e.g. "fintech", "saas"), and multi-term comma-separated queries.

Every result row returns the full crosswalk — the HG industry, the NAICS 2012 code + top-parent sector, and the SIC 1987 code + name.

Free — no credits consumed.

Security

authorization

Query

qstring, >= 2 characters

Free-text search term (min 2 chars). Text queries match case-insensitively as substrings. All-digit queries prefix-match against code columns. Comma-separated terms run as union (OR). Colloquial terms like 'fintech', 'saas' are auto-expanded.

taxonomystring

Scope the search to one taxonomy. Omit to search all three at once.

Enum:"industry""naics""sic"

limitinteger, [ 1 .. 500 ]

Page size (1-500).

Default:50

offsetinteger, [ 0 .. 10000 ]

Page offset (0-10000).

Default:0

naics_leaf_onlyboolean

Only applied when taxonomy=naics. When true, returns only 6-digit leaf codes.

Default:false

GET

/data-api/v2/industries/search

curl -i -X GET \
  'https://api.hginsights.com/data-api/v2/industries/search?q=string&taxonomy=industry&limit=50&offset=0&naics_leaf_only=false' \
  -H 'Authorization: Bearer <YOUR_API_KEY_HERE>'

Responses

Industry search results

Bodyapplication/json

alias_expansionsArray of objects or null

Populated when one or more q terms were treated as colloquial aliases and expanded server-side.

paginationobjectrequired

Pagination metadata.

resultsArray of objectsrequired

Matched industry crosswalk rows.

suggestionsArray of strings or null

Populated only when 0 results and q was a text term. Up to 5 closest taxonomy names by trigram distance.

Response

{
  "alias_expansions": [
    { … }
  ],
  "pagination": {
    "has_more": true,
    "limit": 0,
    "offset": 0,
    "offset_exceeds_total": true,
    "total": 0,
    "total_pages": 0
  },
  "results": [
    { … }
  ],
  "suggestions": [
    "string"
  ]
}