Skip to main content

Company Cloud Spend

company_cloud_spend — which cloud / CDN / hosting / DNS / SaaS vendors does a company use; cloud vendor footprint grouped by service category (HG Insights v2). Use when a user asks WHICH cloud/CDN/hosting/DNS/SaaS vendors a company uses, when each was first detected, and the company's geographic web-traffic split (North America / EMEA / Asia Pacific / Latin America %). Identify the company by company_domain (required); hg_id is NOT supported by this v2 endpoint. Returns: company (name/website/logo), traffic_distribution (regional %, may be null), and technology_services (service_name with vendors[]: vendor_name, vendor_logo, first_seen). IMPORTANT: despite the 'spend' name, the response contains NO dollar figures — vendors and adoption dates only. Do NOT use for dollar-amount spend: use company_spend for category-level $ spend; use company_technographic for on-premise/general software installs (CRM, databases, security). Use product_list to filter to specific vendor/product names (server-side fuzzy matching). Default: capped at 10 vendors per service and 100 vendors total; raise limit (max 200) or set full=true to bypass all caps (may exceed 90 KB on large accounts). The fields param projects vendor rows to a subset of: vendor_name (always included), vendor_logo, first_seen.

Credits​

2 — Per call. See the full credit table for how AI Credits work.

Parameters​

NameTypeDefaultDescription
company_domain Requiredstring-Registered/primary web domain of the company to look up cloud vendors for (e.g., 'cisco.com'). Required — this v2 endpoint is domain-only and does NOT accept hg_id. Protocol prefixes (http://, https://), a leading www., and any trailing path/query/fragment are accepted and stripped automatically; case is normalized to lowercase. Max 253 chars. Must resolve to a company in HG's cloud-vendor database or the call returns a 'Company not found' error.
product_listarray[]Optional vendor/product names to narrow the results to (e.g., ['Amazon EC2', 'OpenDNS']). Matched fuzzily server-side against detected vendor names, so approximate names still match; service categories with no matching vendor are dropped. Omit or pass [] to return every detected vendor.
limitinteger50Maximum number of technology_services (service-category) entries to return (default: 50, max: 200). Ignored when full=true.
vendors_per_service_limitinteger10Maximum number of vendors to include per technology_services (service-category) entry (default: 10, max: 50). Ignored when full=true. The total vendor count across all services is also capped at 100 to keep responses small.
fieldsarray-Project each vendor row to this subset of fields. vendor_name is always included regardless of this list. Ignored when full=true.
fullbooleanfalseWhen true, return the full payload with no limit, no per-service vendor cap, no total-vendor budget, and no field projection. Default: false (all caps apply). Use full=true only when you genuinely need the unbounded payload — large accounts may exceed 90 KB.

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​

  • Which cloud, CDN, hosting, DNS, and SaaS vendors does a company use? — call by company_domain
  • Does a company use a specific cloud vendor (e.g., Amazon EC2 or OpenDNS)? — product_list fuzzy filter
  • When did a company first adopt a given cloud vendor? — read first_seen per vendor
  • How is a company's web traffic distributed across regions? — read traffic_distribution percentages
  • Compare the cloud/CDN vendor footprint of two companies — one call per domain

Example Usage​

Cisco's full cloud/internet-infrastructure vendor footprint by domain

{
"tool": "company_cloud_spend",
"arguments": {
"company_domain": "cisco.com"
}
}

Check whether Cisco uses Amazon EC2 or OpenDNS

{
"tool": "company_cloud_spend",
"arguments": {
"company_domain": "cisco.com",
"product_list": [
"Amazon EC2",
"OpenDNS"
]
}
}

Compact call for a large account — vendor names only, tighter caps

{
"tool": "company_cloud_spend",
"arguments": {
"company_domain": "microsoft.com",
"fields": [
"vendor_name"
],
"vendors_per_service_limit": 5
}
}

Response Format​

FieldTypeDescription
companyobjectCompany information
company.namestringCompany name
company.websitestringCompany website
company.logostring | nullCompany logo URL (null when unavailable)
traffic_distributionobject | nullGeographic distribution of company's web traffic (may be null for some companies)
technology_servicesarrayTechnology services and vendors used by the company
technology_services[].service_namestringName of the technology service category
technology_services[].vendorsarray
technology_services[].vendors[].vendor_namestringName of the vendor
technology_services[].vendors[].vendor_logostring | nullVendor logo URL (null when unavailable; omitted when projected away via fields)
technology_services[].vendors[].first_seenstring | nullDate when vendor was first detected (may be null; omitted when projected away)

company_spend, company_technographic, company_install_time_series, get_vendor_information, search_companies