Quickstart

Go from zero to your first API response in under 2 minutes.

Log in to the HG Admin Portal and go to Settings > API Keys to generate your key. It starts with hg_v2_.

Don't have access? Contact your account manager.

Pick any tool you're comfortable with:

• Terminal — Run the curl command below
• Try-it console — Click Try it on any endpoint in the API Reference and paste your key
• Postman — Import the OpenAPI spec and set your Bearer token
• Claude Code — Ask it to "call the HG API to enrich walmart.com"

See the Explore the API guide for detailed setup instructions for each tool.

Here's the curl version — replace YOUR_API_KEY and run:

curl -X POST "https://api.hginsights.com/data-api/v2/companies/enrich" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "companies": {
    "domains": ["walmart.com"]
  },
  "fields": ["firmographics"]
}'

You should get back Walmart's firmographic data:

{
  "companies": [
    {
      "id": "1698C53EBC888758570396E0334965C1",
      "domain": "walmart.com",
      "firmographics": {
        "name": "Walmart Inc.",
        "domain": "walmart.com",
        "country_code": "US",
        "city_name": "Bentonville",
        "state_name": "AR",
        "employees_total": 2100000,
        "revenue_total": 713163000000,
        "industry_name": "Retail Trade",
        "fortune_500_rank": 1
      }
    }
  ]
}

That's it — you're connected.

Add technographics to see the company's tech stack:

curl -X POST "https://api.hginsights.com/data-api/v2/companies/enrich" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "companies": {
    "domains": ["walmart.com"]
  },
  "fields": ["firmographics", "technographics"]
}'

Only want Salesforce products? Add a filter:

curl -X POST "https://api.hginsights.com/data-api/v2/companies/enrich" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "companies": {
    "domains": ["walmart.com"]
  },
  "fields": ["technographics"],
  "filters": {
    "technographics": {
      "vendors": {
        "names": ["Salesforce"]
      }
    }
  }
}'

401 Unauthorized — Your API key is missing, incorrect, or has been revoked. Regenerate it from admin.hginsights.com under Settings > API Keys.

402 Payment Required — Your organization has no credits available (exhausted or expired contract). Check your balance via the Credits endpoint and contact your account manager to add credits.

422 Unprocessable Entity — Check your request body. The companies and fields parameters are required. Make sure the JSON is valid.

No data returned — The company may not be in HG's database, or you may not have access to the requested field groups. Check your entitlements via the Credits endpoint or contact your account manager.