Skip to content

HG Insights API

HG Insights API v2

The v2 API provides company enrichment with firmographics, spend, and technographics data.

Authentication

All API requests require authentication using an API token.

Getting Your Token

Contact your HG Insights account manager to obtain an API token.

Using Your Token

Include your token in the Authorization header:

curl -X POST "https://api.hginsights.com/data-api/api/v2/companies/enrich" \
  -H "Authorization: YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"companies": {"ids": ["COMPANY_ID"]}}'

Important: Do not include "Bearer" prefix. Use the token directly.

Token Format

v2 tokens start with hg_v2_ followed by a random string.

Example: hg_v2_K3WnkKrSyVD8yOoGTu1oqujB0f37eJuen1wvV2Ptg0

Company Enrichment

The enrichment endpoint returns firmographics, spend, and technographics data for companies.

Request Example

{
  "companies": {
    "ids": ["1698C53EBC888758570396E0334965C1"]
  },
  "fields": ["firmographics", "spend", "technographics"]
}

Parameters

ParameterTypeRequiredDescription
companies.idsarrayYesCompany IDs (hex format, max 50)
fieldsarrayNoData categories to return

Field Groups

  • firmographics - Company info, location, revenue, employees
  • spend - IT spend by category
  • technographics - Technology installs

Response Example

{
  "companies": [
    {
      "company_id": "1698C53EBC888758570396E0334965C1",
      "firmographics": {
        "name": "Walmart Inc.",
        "url": "walmart.com",
        "country_code": "US",
        "employees_total": 2100000,
        "revenue_total": 680985000000
      },
      "spend": {
        "all": [...],
        "all_count": 135
      },
      "technographics": {
        "installs": [...],
        "installs_count": 5900
      }
    }
  ]
}

Filtering Technographics

Filter installs by vendor, product, or category:

{
  "companies": {"ids": ["..."]},
  "fields": ["technographics"],
  "filters": {
    "technographics": {
      "vendors": {"ids": [316]},
      "products": {"ids": [814]}
    }
  }
}

Entitlements

Your API token includes entitlements that determine which data you can access.

Basic Tier

Firmographics: Company name, URL, country, industry

Spend: Absolute spend amounts only

Technographics: Not included

Full Tier

Firmographics: All 48 fields including revenue, employees, HQ info, rankings

Spend: Full details with category name, description, country

Technographics: Full install data with product, vendor, intensity, dates, categories

Checking Your Entitlements

Make a request and check which fields are returned. Fields outside your entitlements will be omitted from the response.

Upgrading

Contact your HG Insights account manager to upgrade your entitlements.

Download OpenAPI description
openapi.json
openapi.yaml
Overview
License
HG Insights terms of service
Languages
Servers
https://api.hginsights.com

Companies

Operations

Enrich Companies

Request

Unified endpoint to enrich company data with firmographics, spend, and technographics.

Select which data categories to include using the fields parameter. By default, all categories are included. Filter technographics by categories, vendors, or products using the filters parameter. Control pagination for both companies and nested technographics data.

Security
authorization
Bodyapplication/jsonrequired

Enrich Request

companiesobject(CompaniesFilter)required

Filter companies by IDs

Example: {"ids":["78040737422146204640576327630924184547","1698C53EBC888758570396E0334965C1"]}
companies.​idsArray of strings(HexId)[ 1 .. 50 ] itemsrequired

Array of hex-encoded company IDs

Example: ["78040737422146204640576327630924184547","1698C53EBC888758570396E0334965C1"]
fieldsArray of strings(FieldGroups)

Which data categories to include in the response

Items Enum"firmographics""spend""technographics"
Example: ["firmographics","spend","technographics"]
filtersobject(EnrichFilters)

Filters for enrich request

paginationobject(RequestPagination)

Pagination parameters for companies and nested data

curl -i -X POST \
  https://api.hginsights.com/data-api/v2/companies/enrich \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "companies": {
      "ids": [
        "78040737422146204640576",
        "1698C53EBC888758570396E0334965C1"
      ]
    },
    "fields": [
      "firmographics",
      "spend",
      "technographics"
    ],
    "filters": {
      "technographics": {
        "categories": {
          "ids": [
            "319D067B229178F03BCFA"
          ]
        },
        "products": {
          "ids": [
            814
          ]
        },
        "vendors": {
          "ids": [
            316
          ]
        }
      }
    },
    "pagination": {
      "technographics": {
        "limit": 25,
        "offset": 0
      }
    }
  }'

Responses

Enrich Response

Bodyapplication/json
companiesArray of objects(CompanyEnrichObject)
Example: [{"company_id":"78040737422146204640576327630924184547","firmographics":{"company_name":"Example Corp","country_code":"US","domain_name":"example.com","hg_id":"78040737422146204640576327630924184547"},"spend":{"all":[{"absolute_spend":125000,"category_id":"319D067B229178F03BCFA1DA4AC4DEDE","category_name":"Software","country_code":"US"}],"all_count":1},"technographics":{"installs":[{"country_code":"US","product_id":814,"product_intensity":5,"product_last_verified_date":"2024-05-20","product_name":"Java","vendor_name":"Oracle"}],"installs_count":1}}]
Response
application/json
{
  "companies": [
    { … }
  ]
}