Skip to content
Last updated

Company Enrichment

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

Endpoint

POST /api/v2/companies/enrich

Request

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

Parameters

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

Field Groups

You can request specific data categories by including them in the fields array:

  • firmographics - Company information including name, domain, location, industry classification, revenue, employee counts, and HG rankings
  • spend - IT spending data organized by technology category, including spend amounts and category details
  • technographics - Technology installation data including products, vendors, usage intensity, installation dates, and product categories

If you omit the fields parameter, all available field groups will be returned in the response.

Response

{
  "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]}
    }
  }
}