Skip to main content

Company Research

EXPENSIVE — full-profile dashboard, ~10 credits per call. Builds one multi-signal company profile in a single call: firmographic (industry, size, revenue, HQ, rankings) + technographic (installed tech stack) + IT spend + cloud spend + intent signals + federal contracts + operating signals, aggregated into an interactive dashboard.

Use this when the user explicitly asks for a broad company overview, briefing, or account snapshot spanning MULTIPLE data domains at once — the whole point is getting the complete picture in one call.

Do NOT use this when you only need ONE signal — for any narrow question, call that individual tool instead: company_firmographic (industry/size/revenue), company_technographic (tech stack), company_intent (buying signals), or company_spend (IT spend). The specific tool is far faster, returns a smaller payload, and costs a fraction of this. Do not call this repeatedly for the same company.

Provide a company domain (e.g., "cisco.com") or an HG Insights company ID (hg_id). All sections default to ON and you are billed for every section returned — pass include* booleans (false) to drop sections you do not need and pay less. Pass full: true to bypass per-section row caps (defaults trim spend/cloudSpend/intent so an unconstrained call stays under 40KB).

Parameters

NameTypeRequiredDefaultDescription
companyDomainstring❌ No-The company domain to look up (e.g., "cisco.com"). At least one of companyDomain or hg_id must be provided. Protocol prefixes (http://, https://), leading www., and trailing paths/queries/fragments are accepted and stripped automatically; case is normalized.
hg_idstring❌ No-HG Insights company ID (32 alphanumeric characters, e.g. from a company_search result). When provided, this overrides companyDomain. At least one of companyDomain or hg_id must be provided.
includeFirmographicboolean❌ NotrueInclude firmographic data — industry, size, revenue, HQ, rankings (default: true). Cannot be disabled: firmographic is the mandatory header source and is always fetched regardless of this flag.
includeTechnographicboolean❌ NotrueInclude the installed technology stack, top 20 products by intensity (default: true). Set false to drop this section and save credits when the tech stack is not needed.
includeSpendboolean❌ NotrueInclude IT spend broken down by category (default: true). Set false to skip the fetch and save credits.
includeCloudSpendboolean❌ NotrueInclude cloud spend by service and vendor (default: true). Set false to skip the fetch and save credits.
includeIntentboolean❌ NotrueInclude intent topics and activities (buying signals) (default: true). Set false to skip the fetch and save credits.
includeContractsboolean❌ NotrueInclude federal (government) contract data (default: true). Set false to skip the fetch and save credits.
includeOperatingSignalsboolean❌ NotrueInclude operating signals (e.g. work model, operational posture) (default: true). Set false to skip the fetch and save credits.
fullboolean❌ NofalseWhen true, bypass the per-section row caps applied to technographic, spend, cloudSpend, intent, and contracts so every row is returned. Default: false (caps applied so a no-arg call stays under Claude's ~40KB inline cap). Only set true when the caller explicitly needs the complete, untruncated dataset.

Required Integrations

  • hginsights_v2

Use Cases

  • Give me a full briefing / account snapshot on a company — one call covering profile, tech, spend, and intent
  • I'm prepping for a sales meeting with company X and need the complete picture across every data domain
  • Build a company overview dashboard combining firmographics, tech stack, spend, and buying signals
  • I have an hg_id from search_companies and want the full multi-signal profile for it
  • Show everything HG knows about this company in one place

Example Usage

Full profile by domain

{
"tool": "company_research",
"arguments": {
"companyDomain": "cisco.com"
}
}

Profile by hg_id, skip contracts + gov signals

{
"tool": "company_research",
"arguments": {
"hg_id": "25582D0E650950949A473EA7345C193E",
"includeContracts": false
}
}

Untruncated full dataset

{
"tool": "company_research",
"arguments": {
"companyDomain": "salesforce.com",
"full": true
}
}

company_firmographic, company_technographic, company_intent, company_spend, company_cloud_spend