Skip to content
Last updated

The HG Insights API provides multiple categories of company data. This guide explains what each one contains and how to interpret it.

Data Overview

POST /companies/enrich returns field groups you can request independently:

  • Firmographics — Company profile and business information
  • Spend — IT spending and budget data
  • Technographics — Technology installations and usage
  • AI Maturity — Composite AI readiness score (0–100), global rank, 6-month score delta, data maturity level (LOW/MEDIUM/HIGH), cloud intensity by provider (AWS/Azure/GCP), and GenAI buying intent score
  • Contracts — Technology contract records including vendor, deal value, start/end dates, and active status

Dedicated endpoints return data not available through /enrich:

  • Functional Area Intelligence (/companies/functional-areas) — Department-level technology usage by location, with decision maker and influencer job titles
  • Corporate Hierarchy (/companies/hierarchy) — Full company tree from global HQ down to subsidiaries
  • Intent Signals (/intent/enrich) — HG Contextual Intent (topic-based signals from 4,000+ B2B topics, contextualized against a company's tech stack) and TrustRadius buyer activities (first-party signals from product reviews and comparisons). See the Intent guide.
  • Contract Search (/contracts/search) — Search and filter contracts across companies by vendor, category, deal value, dates, signing country, and active status.
  • Contacts (/contacts/search, /contacts/enrich) — Find decision makers and influencers by job function, seniority, location, and time in role. Enrich by contact ID to retrieve email and phone.

The fields and endpoints available depend on your subscription plan.


Firmographics

Firmographics provide fundamental company information including identity, location, size, industry classification, and corporate hierarchy.

Company Identity

FieldTypeDescriptionExample
idstringHG company ID"E48EDEB162A5FBFDAF2DCF707079F8F"
namestringOfficial company name"Walmart Inc."
domainstringPrimary company domain"walmart.com"
domain_normalizedstringNormalized domain"walmart.com"

Location

FieldTypeDescriptionExample
country_codestringISO country code"US"
country_namestringFull country name"United States"
state_namestringState or region"Arkansas"
city_namestringCity"Bentonville"
postal_codestringZIP or postal code"72716"
continent_namestringContinent"North America"
subcontinent_namestringSubcontinent region"Northern America"
geopolitical_namestringGeopolitical region"Americas"

Company Size

FieldTypeDescriptionExample
employees_totalintegerTotal employee count2100000
employees_bandstringEmployee range band"100K+"
revenue_totalnumberAnnual revenue in USD680985000000
revenue_bandstringRevenue range band"$100B+"
it_spendnumberTotal estimated IT spend in USD15000000000

Industry Classification

FieldTypeDescriptionExample
industry_idintegerHG industry identifier42
industry_namestringPrimary industry"Retail"
naics_codestringNAICS code"452311"
naics_namestringNAICS description"Warehouse Clubs and Supercenters"
sic_codesarraySIC codes["5331"]
sic_namesarraySIC descriptions["Variety Stores"]

Rankings

FieldTypeDescriptionExample
fortune_500_rankintegerFortune 500 ranking (if applicable)1
forbes_2000_rankintegerForbes 2000 ranking (if applicable)15

Corporate Hierarchy (Premium)

For companies that are subsidiaries or part of a larger organization, the API returns the global headquarters data:

FieldTypeDescription
company_levelstringPosition in corporate hierarchy
global_hq_idstringHG ID of the global headquarters
global_hq_namestringName of the global headquarters
global_hq_domainstringDomain of the global headquarters
global_hq_domain_normalizedstringNormalized domain of the global HQ
global_hq_country_codestringCountry code of the global HQ
global_hq_country_namestringCountry name of the global HQ
global_hq_state_namestringState of the global HQ
global_hq_city_namestringCity of the global HQ
global_hq_postal_codestringPostal code of the global HQ
global_hq_continent_namestringContinent of the global HQ
global_hq_subcontinent_namestringSubcontinent of the global HQ
global_hq_geopolitical_namestringGeopolitical region of the global HQ
global_hq_employees_bandstringEmployee band of the global HQ
global_hq_revenue_bandstringRevenue band of the global HQ
global_hq_industry_idintegerIndustry ID of the global HQ
global_hq_industry_namestringIndustry name of the global HQ
global_hq_naics_codestringNAICS code of the global HQ
global_hq_naics_namestringNAICS name of the global HQ
global_hq_sic_codesarraySIC codes of the global HQ
global_hq_sic_namesarraySIC names of the global HQ
global_hq_fortune_500_rankintegerFortune 500 rank of the global HQ
global_hq_forbes_2000_rankintegerForbes 2000 rank of the global HQ

Technographics

Technographics reveal the specific technologies a company has installed, providing detailed insights into their tech stack.

Install Record Fields

Each install record represents a single technology detected at a company:

FieldTypeDescriptionExample
product_idintegerHG product identifier814
product_namestringName of the technology product"Salesforce CRM"
product_descriptionstringProduct description"Customer relationship management platform"
vendor_idintegerHG vendor identifier316
vendor_namestringName of the vendor"Salesforce"
vendor_domainstringVendor's website"salesforce.com"
product_category_idstringHG category identifier"63E88D6A88D45AB23B4CB4E71CB5A2E"
product_category_level1_namestringTop-level category"Software"
product_category_level2_namestringSecond-level category"Business Applications"
product_category_level3_namestringThird-level category"CRM"
product_category_level4_namestringFourth-level category (if applicable)
product_category_level5_namestringFifth-level category (if applicable)
product_last_verified_datestringWhen the technology was last verified in use"2026-03-15"
product_first_verified_datestringWhen the technology was first detected"2023-06-01"
country_codestringCountry where the technology is installed"US"
intensityintegerUsage intensity score5
location_countintegerNumber of locations using this technology12

The response includes:

  • installs — Array of install records
  • installs_count — Total number of products installed

Example Install Record

{
  "product_id": 814,
  "product_name": "Salesforce CRM",
  "product_description": "Customer relationship management platform",
  "vendor_id": 316,
  "vendor_name": "Salesforce",
  "vendor_domain": "salesforce.com",
  "product_category_id": "63E88D6A88D45AB23B4CB4E71CB5A2E",
  "product_category_level1_name": "Software",
  "product_category_level2_name": "Business Applications",
  "product_category_level3_name": "CRM",
  "product_last_verified_date": "2026-03-15",
  "product_first_verified_date": "2023-06-01",
  "country_code": "US",
  "intensity": 5,
  "location_count": 12
}

Understanding Install Data

  • Product vs Vendor: Products are specific tools (e.g., Salesforce CRM); vendors are the companies that make them (e.g., Salesforce)
  • Verified dates: product_last_verified_date indicates when HG last confirmed the technology is in use; product_first_verified_date shows when it was first detected
  • Categories: Technologies are organized in a 5-level hierarchy, from broad (level 1) to specific (level 5)
  • Intensity: A score indicating how heavily the technology is used
  • Location count: How many company locations are using this technology

Spend

Spend data reveals IT budget allocation across technology categories, helping you understand where companies invest in technology.

Spend Record Fields

Each spend record represents spending in a single technology category:

FieldTypeDescriptionExample
category_idstringHG category identifier"319D067B229178F03BCFA1DA4AC4DEDE"
category_namestringTechnology category name"Cloud Infrastructure"
category_descriptionstringCategory description"Cloud computing infrastructure services"
spendnumberEstimated annual spend in USD5000000
country_codestringCountry of the spend"US"
country_namestringCountry name"United States"

The response includes:

  • all — Array of spend records
  • all_count — Total number of spend categories

Example Spend Record

{
  "category_id": "319D067B229178F03BCFA1DA4AC4DEDE",
  "category_name": "Cloud Infrastructure",
  "category_description": "Cloud computing infrastructure services",
  "spend": 5000000,
  "country_code": "US",
  "country_name": "United States"
}