Skip to main content

Search Industries (NAICS / SIC)

search_industries_naics_sic resolves industry names and translates codes across the three industry taxonomies HG Insights tracks — HG industry, NAICS 2012, and SIC 1987 — in a single call. The tool proxies GET /v2/industries/search from the HG Insights v2 API.

Three use cases:

  1. Free-text lookup — pass q with a name fragment (e.g. "software publishers") and get ranked crosswalk rows. matched_on tells you which taxonomy hit (precedence: industry > naics > sic).
  2. Code translation — pass q with a known code (e.g. "541511", "7372") and get the full crosswalk for that code.
  3. Grouped listing — pass taxonomy (industry, naics, or sic) to get one row per distinct entity in that taxonomy with crosswalk counts (naics_count, sic_count) on the matched block.

Parameters​

NameTypeRequiredDefaultDescription
qstring (min 2 chars)No—Case-insensitive substring. Matches names of all three taxonomies and numeric codes (naics_2012_code, sic_1987_code, sic_1987_standard_code).
taxonomyindustry | naics | sicNo—Restricts matching to one taxonomy AND groups results by its primary key.
limitint (1–500)No50Page size.
offsetint (≥ 0)No0Page offset.

Required Integrations​

  • hginsights_v2

Credit Cost​

Free — this tool does not consume any credits.

Example Usage​

Free-text lookup​

{
  "tool": "search_industries_naics_sic",
  "parameters": { "q": "software publishers" }
}

Translate a known NAICS code​

{
  "tool": "search_industries_naics_sic",
  "parameters": { "q": "541511" }
}

List all HG industries (grouped)​

{
  "tool": "search_industries_naics_sic",
  "parameters": { "taxonomy": "industry", "limit": 100 }
}

Response Format​

{
  "results": [
    {
      "matched_on": "naics",
      "industry": { "industry_id": 12, "industry_name": "Software" },
      "naics": {
        "naics_code": "541511",
        "naics_name": "Custom Computer Programming Services",
        "naics_top_parent_code": "54",
        "naics_top_parent_name": "Professional, Scientific, and Technical Services"
      },
      "sic": {
        "sic_code": "7372",
        "sic_standard_code": "7372",
        "sic_name": "Prepackaged Software"
      }
    }
  ],
  "pagination": { "total": 38, "limit": 50, "offset": 0, "has_more": false }
}

Notes:

  • Null leaf fields are stripped upstream. Blocks unrelated to a row appear as {}.
  • In grouped mode (taxonomy= set), each row contains exactly one populated block with crosswalk counts; the other two blocks are {}.
  • In unscoped mode the same NAICS may appear on multiple rows paired with different SICs (intentional fanout). Use grouped mode when you want deduped entities.
  • Ordering is stable across pages: HG-mapped rows first, then industry_name, naics_2012_code, sic_1987_code.

Error Handling​

CauseSurface
q < 2 charactersTool-side Zod validation error ("at least 2 characters")
Bad limit / offset / taxonomyTool-side Zod validation error
HG API unreachable (503) or timeoutStructured upstream error; no credits consumed (tool is free anyway)
401 from HGAuthentication error — re-check hginsights_v2 credential
  • hg_catalog — Discover warehouse tables, including those keyed on industry / NAICS / SIC.
  • intent_category — Pair an industry filter with intent search.
  • search_companies — Filter companies by an industry taxonomy once you know the code.

Next Steps​