# Understanding HG Data

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.

## Field Groups Overview

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

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

### Key Fields

| 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" |


### Industry Classification

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

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

### Key Fields

| 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 |


### Example Spend Record


```json
{
  "category_name": "Cloud Infrastructure",
  "category_id": "ABC123",
  "spend_amount": 5000000
}
```

To explore available spend categories, visit [HG Discovery Categories](https://discovery.hginsights.com/categories).

## Technographics

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

### Key Fields

| 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") |


### Example Install Record


```json
{
  "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"
}
```

### Understanding Install Data

- **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](https://discovery.hginsights.com/).

To browse technology categories, visit [HG Discovery Categories](https://discovery.hginsights.com/categories).