Skip to main content

Company Spend

company_spend — IT spend estimate / how much a company spends on IT / technology budget breakdown in USD by category and country, from HG Insights modeled data. Values are modeled dollar estimates (not invoices) — e.g. "Total IT", "Total External IT", "Services", "Software", each split by country. Accepts a batch: pass hg_ids OR domains (up to 25; mutually exclusive — hg_ids wins when both supplied). One entry per matched company; unmatched omitted. Returns spend.all (snake_case rows: spend, category_name, category_id, country_name, country_code) plus spend.all_count. Filter by category_ids or category_names. WARNING: category_names is case-insensitive substring match (max 10); a non-matching name returns 0 rows — prefer category_ids or resolve names via get_product_category. Paginate with max_results and offset. Credits: 3 per matched company returned; unmatched companies cost nothing. Do NOT use for cloud-vendor-level spend or which cloud/CDN/hosting vendors a company uses — use company_cloud_spend. Do NOT use for AI/ML platform spend — use company_ai_spend. Do NOT use to list installed software/products — use company_technographic.

Credits​

3 — 3 per company returned. See the full credit table for how AI Credits work.

Parameters​

NameTypeDefaultDescription
hg_idsarray-HG Insights company IDs for batch spend lookup (up to 25). Each is 31-32 alphanumeric/hex chars, from a previous search_companies result. Provide hg_ids OR domains (at least one is required); the two are mutually exclusive — if both are supplied, hg_ids takes precedence.
domainsarray-Company domains for batch spend lookup (e.g. ['cisco.com', 'salesforce.com'], up to 25). Protocol prefixes, leading www., and trailing paths are stripped automatically; case is normalized. Provide hg_ids OR domains; the two are mutually exclusive — if both are supplied, hg_ids takes precedence.
category_idsarray-Filter USD spend rows to these HG category IDs (string array of hex ids, e.g. from get_product_category). Exact-match and the reliable filter — prefer over category_names. Forwarded as filters.spend.categories.ids to the upstream.
category_namesarray-Filter USD spend rows by category name (string array, max 10 — the upstream cap), e.g. ["Security","Software"]. Case-insensitive substring match: a name that is not a substring of any catalog category returns 0 rows — prefer category_ids or resolve exact names via get_product_category. Forwarded as filters.spend.categories.names to the upstream.
max_resultsinteger-Maximum number of spend rows (category × country combinations) to return per company (1–25 — the HG spend pagination cap). Forwarded as pagination.spend.limit to the upstream.
offsetinteger-Zero-based row offset for pagination. Forwarded as pagination.spend.offset to the upstream.

Required Integrations​

This tool is only available when your organization has the following integration configured in the HG Insights Integrations settings:

  • HG Insights (Data API) (hginsights_v2_data_api)

Use Cases​

  • How much does a company spend on IT overall (annual USD estimate)? — call by domain, read the "Total IT" row in spend.all
  • What does a company spend within a category (Security, Software, Cloud, Services)? — filter with category_ids/category_names
  • Which spend categories are largest for a company? — read spend.all rows and compare their spend values
  • How is a company's IT spend distributed across countries? — read country_name/country_code on each row
  • Size a deal or compare two companies' IT budgets — pass both domains in one batch call, compare their Total IT rows

Example Usage​

Cisco's IT spend rows by category and country

{
  "tool": "company_spend",
  "arguments": {
    "domains": [
      "cisco.com"
    ]
  }
}

Compare Cisco and Salesforce IT spend in one batch

{
  "tool": "company_spend",
  "arguments": {
    "domains": [
      "cisco.com",
      "salesforce.com"
    ]
  }
}

Top 5 spend rows filtered to Security and Software

{
  "tool": "company_spend",
  "arguments": {
    "domains": [
      "cisco.com"
    ],
    "category_names": [
      "Security",
      "Software"
    ],
    "max_results": 5
  }
}

Response Format​

FieldTypeDescription
companiesarray
companies[].company_idstringHG Insights company id (hex). Empty string when not found.
companies[].company_domainstringThe resolved company domain.
companies[].spendobjectSpend section from the HG v2 API — thin upstream passthrough. Rows are snake_case (e.g. category_name, country_name, spend).
companies[].spend.allarrayArray of spend rows (snake_case v2 passthrough).
companies[].spend.all_countnumberTotal number of spend rows in this response.
companies[].credits_consumednumberCredits consumed for this company: 3 per matched company returned, even when it has no spend rows. Requested companies that do not match are not returned and cost nothing.

company_cloud_spend, company_ai_spend, company_technographic, company_firmographic, search_companies, get_product_category