The HG Insights API provides three main categories of company data. This guide explains what each field group contains and how to interpret the data.
The API organizes data into three field groups that you can request independently:
- Firmographics - Company profile and business information
- Spend - IT spending and budget data
- Technographics - Technology installations and usage
Each field group contains specific data points that give you comprehensive insights into a company.
Firmographics provide fundamental company information including identity, location, size, and industry classification.
| Field | Type | Description | Example |
|---|---|---|---|
name | string | Official company name | "Walmart Inc." |
url | string | Primary company domain | "walmart.com" |
country_code | string | ISO country code | "US" |
country_name | string | Full country name | "United States" |
state | string | State or region | "Arkansas" |
city | string | City location | "Bentonville" |
address | string | Physical address | "702 SW 8th St" |
postal_code | string | ZIP or postal code | "72716" |
employees_total | integer | Total employee count | 2100000 |
revenue_total | integer | Annual revenue in USD | 680985000000 |
industry | string | Primary industry | "Retail" |
sic_code | string | Standard Industrial Classification | "5331" |
naics_code | string | North American Industry Classification | "452311" |
Companies are classified using multiple taxonomies:
- SIC codes: Standard Industrial Classification (legacy system)
- NAICS codes: North American Industry Classification System (modern standard)
- Industry: Human-readable industry category
Spend data reveals IT budget allocation across technology categories, helping you understand where companies invest in technology.
| Field | Type | Description |
|---|---|---|
all | array | List of all spend records |
all_count | integer | Total number of spend categories |
category_name | string | Technology category name |
category_id | string | HG category identifier |
spend_amount | integer | Estimated annual spend in USD |
{
"category_name": "Cloud Infrastructure",
"category_id": "ABC123",
"spend_amount": 5000000
}To explore available spend categories, visit HG Discovery Categories.
Technographics reveal the specific technologies a company has installed, providing detailed insights into their tech stack.
| Field | Type | Description |
|---|---|---|
installs | array | List of technology installations |
installs_count | integer | Total number of products installed |
product_name | string | Name of the technology product |
product_id | integer | HG product identifier |
vendor_name | string | Name of the vendor/manufacturer |
vendor_id | integer | HG vendor identifier |
category_name | string | Technology category |
category_id | string | HG category identifier |
install_date | string | When technology was first detected |
usage_intensity | string | Level of usage (e.g., "High", "Medium", "Low") |
{
"product_name": "Salesforce Sales Cloud",
"product_id": 814,
"vendor_name": "Salesforce",
"vendor_id": 316,
"category_name": "CRM",
"install_date": "2020-01-15",
"usage_intensity": "High"
}- Product vs Vendor: Products are specific tools; vendors are the companies that make them
- Install date: When HG first detected the technology in use
- Usage intensity: Indicates depth of adoption (High = mission-critical, Low = limited use)
- Categories: Technologies grouped by function (CRM, Cloud, Security, etc.)
To explore products and vendors tracked by HG Insights, visit HG Discovery.
To browse technology categories, visit HG Discovery Categories.