Skip to main content

Company AI Spend

company_ai_spend — estimated annual AI spend / GenAI budget / how much a company spends on AI (USD), broken down by AI category and country, from HG Insights v2. Each row: spend (USD), category_name / category_id (e.g. "Total AI Spend", "AI Software", "AI Services", "AI Hardware"), and country_name / country_code. Accepts a batch: pass hg_ids OR domains (up to 25; mutually exclusive — hg_ids wins when both supplied). One entry per matched company under companies[] (unmatched omitted). Filter with category_ids or category_names. WARNING: category_names is case-insensitive substring match (max 10); non-matching name returns 0 rows — prefer category_ids or resolve names via the spend-categories catalog. Paginate with max_results (1–25) and offset. Credits: 2 per matched company returned; unmatched companies cost nothing. Do NOT use for total/overall IT spend across all categories — use company_spend. Do NOT use for cloud-vendor spend breakdowns (AWS/Azure/GCP) — use company_cloud_spend. Do NOT use for AI adoption/maturity scores (this returns dollar spend, not scores) — use company_ai_maturity.

Credits​

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

Parameters​

NameTypeDefaultDescription
hg_idsarray-HG Insights company IDs for batch AI-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 AI-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 AI-spend rows to these HG AI-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.ai_spend.categories.ids to the upstream.
category_namesarray-Filter AI-spend rows by AI-category name (string array, max 10 — the upstream cap), e.g. ["AI Software","AI Services"]. 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 the spend-categories catalog (GET /data-api/v2/catalog/spend_categories). Forwarded as filters.ai_spend.categories.names to the upstream.
max_resultsinteger-Maximum number of AI-spend rows to return (1–25 — the HG spend pagination cap). Forwarded as pagination.ai_spend.limit to the upstream.
offsetinteger-Zero-based row offset for pagination. Forwarded as pagination.ai_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 AI overall (estimated annual USD)? — call by domain, read the "Total AI Spend" row in ai_spend.all
  • What does a company spend within an AI category (AI Software, AI Services, AI Hardware)? — filter with category_ids/category_names
  • Which AI categories are largest for a company? — read ai_spend.all rows and compare their spend values
  • Compare two companies' AI budgets — pass both domains in one batch call and compare their Total AI Spend rows
  • How is a company's AI spend distributed across countries? — read country_name/country_code on each row

Example Usage​

Cisco's AI spend rows by category and country

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

Compare Cisco and Salesforce AI spend in one batch

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

Top 3 AI-spend rows filtered to AI Software and AI Services

{
  "tool": "company_ai_spend",
  "arguments": {
    "domains": [
      "cisco.com"
    ],
    "category_names": [
      "AI Software",
      "AI Services"
    ],
    "max_results": 3
  }
}

Response Format​

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

company_spend, company_cloud_spend, company_ai_maturity, company_technographic, search_companies, get_product_category