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
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
companyDomain | string | ❌ 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_id | string | ❌ 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. |
includeFirmographic | boolean | ❌ No | true | Include 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. |
includeTechnographic | boolean | ❌ No | true | Include 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. |
includeSpend | boolean | ❌ No | true | Include IT spend broken down by category (default: true). Set false to skip the fetch and save credits. |
includeCloudSpend | boolean | ❌ No | true | Include cloud spend by service and vendor (default: true). Set false to skip the fetch and save credits. |
includeIntent | boolean | ❌ No | true | Include intent topics and activities (buying signals) (default: true). Set false to skip the fetch and save credits. |
includeContracts | boolean | ❌ No | true | Include federal (government) contract data (default: true). Set false to skip the fetch and save credits. |
includeOperatingSignals | boolean | ❌ No | true | Include operating signals (e.g. work model, operational posture) (default: true). Set false to skip the fetch and save credits. |
full | boolean | ❌ No | false | When 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
}
}
Related Tools
company_firmographic, company_technographic, company_intent, company_spend, company_cloud_spend