Company AI Maturity

Get a company's AI and data maturity signals exactly as HG Insights returns them — scores, rank, buying intent, and per-provider cloud intensity, with no derived stage labels.

Overview

company_ai_maturity is a thin pass-through. Where company_operating_signals rolls the same underlying inputs into derived stages such as ai-leader-accelerating and cloud-native, this tool hands back the raw scores so you can apply your own thresholds.

Reach for it when you need the numbers themselves — to rank a list, feed a model, or set your own cutoffs. Reach for company_operating_signals when you want a ready-made label.

Parameters

Name	Type	Required	Default	Description
companyDomain	string	⚠️ Either this or hg_id	-	Company domain to look up. Protocol prefixes, leading www., and trailing paths are stripped automatically; case is normalized.
hg_id	string	⚠️ Either this or companyDomain	-	HG Insights company ID (31–32 alphanumeric characters). When provided, it takes precedence over companyDomain. Obtain it from a previous search_companies result.

Supplying neither parameter is an error: the call fails with Provide a companyDomain or an hg_id to look up AI maturity. This is distinct from the not-found case below — one means the request was malformed, the other means the request was fine but produced no data.

Required Integrations

• hginsights_v2

Credits

2 credits per lookup.

Response Format

{
  "companyId": "3AB6196C456CE3313A04A57BA6FA7BE3",
  "companyDomain": "salesforce.com",
  "aiMaturity": {
    "ai_maturity_score": 68.67,
    "ai_maturity_rank": 26,
    "ai_maturity_6m_delta": 8.05,
    "ai_product_use": true,
    "genai_intent_score": 52534,
    "data_maturity_level": "MEDIUM",
    "data_maturity_score": 62.72,
    "cloud_centricity": "aws",
    "cloud_intensity": { "aws": 4711, "azure": 3108, "gcp": 2705 }
  }
}

Field meanings

Field	Meaning
ai_maturity_score	Composite AI maturity score on a 0–100 scale.
ai_maturity_rank	Position against all ranked companies, where 1 is the highest. Lower is stronger.
ai_maturity_6m_delta	Change in the maturity score over the last six months. Positive means rising; it can exceed the single-digit range.
ai_product_use	Whether the company has at least one AI product installed.
genai_intent_score	GenAI buying-intent signal. Unbounded — real values run into the tens of thousands, so treat it as a relative measure, not a percentage.
data_maturity_level	LOW, MEDIUM, or HIGH.
data_maturity_score	Data maturity on a 0–100 scale.
cloud_centricity	The provider this company leans on most.
cloud_intensity	Per-provider detection volume — see the caution below.

cloud_intensity is not a percentage

cloud_intensity holds unbounded rolled-up detection volume for each provider — the accumulated count of times that provider's technologies were detected, summed across products and locations over time.

It is not a 0–100 score. In the example above, aws: 4711 does not mean "4711 out of 100" or a dollar figure; it is a detection count, and values in the thousands are normal.

Two further cautions:

• Use it for within-company comparison. The example account leans AWS (4711) over Azure (3108) and GCP (2705). Comparing one company's aws value against another's is misleading, because the number scales with company size and how long the footprint has been observed.
• It does not decay. A high value reflects lifetime detections, so a company that has since moved off a provider can still score high. Check momentum via company_install_time_series before reading a high value as current state.

company_operating_signals exposes these same three numbers, but flat — as gcp_intensity, aws_intensity, and azure_intensity inside its cloud_depth.signals object, rather than nested under cloud_intensity. The values mean the same thing in both places.

Response Notes

• Not found: companyId is "" and aiMaturity is null. This means either the company was not matched or HG has no AI-maturity coverage for it — the two cases are indistinguishable in the response.
• companyDomain echoes back the normalized domain that was queried.

Example Usage

{
  "tool": "company_ai_maturity",
  "parameters": {
    "companyDomain": "salesforce.com"
  }
}

Use Cases

• Ranking a target list by AI maturity using your own thresholds
• Prioritizing GenAI outreach on raw buying-intent scores
• Identifying which cloud provider an account is centered on before a partner-aligned pitch
• Feeding AI-readiness scores into a downstream model or scoring system

Related Tools

• company_operating_signals - The same signals rolled into derived stage labels, with the cloud intensities returned flat instead of nested.
• company_install_time_series - Monthly usage trends; use it to check whether a high cloud_intensity is current or historical.
• company_technographic - Point-in-time snapshot of the company's technology stack.