Company Intent

Get a broad overview of intent signals for a single company — returns the top topics by score (0–100, where 100 = strongest signal) with intent levels (High/Medium/Low), buyer journey stages, and context dispositions (Displacement/Expansion/Complementary/Whitespace) from HG proprietary data. TrustRadius activity events (raw page views with evidence URLs) appear in the activities array.

Use this when: you want the full ranked landscape of what a company is researching (top-N topics by score), competitive signals (set vendor_name + context_type=Displacement), or filtering by journey stage or intent level.

Do NOT use this when:

• You want companies researching a specific topic → use intent_category with topic_name instead.
• You need to discover valid topic names/IDs → use list_intent_topics first.
• You set group_by=company with signal — this activates activity search mode which ignores companyDomain and returns cross-company aggregates; only use that combination if you want a ranked list of companies (not a per-company lookup).
• You set source=trustradius expecting scored topic signals — TrustRadius topics currently return score=0; meaningful TR data is in the activities array only.

Scores are bounded 0–100. intent_level thresholds: High ≥ 85, Medium 65–84, Low < 65 (approximate).

Parameters

Name	Type	Required	Default	Description
companyDomain	string	❌ No	-	Company domain to look up intent signals for (e.g., "cisco.com", "salesforce.com"). Either companyDomain or hg_id is required. 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). When provided, this overrides companyDomain. Obtain from a previous company_search result.
vendor_name	string	❌ No	-	Filter by vendor name for competitive/displacement analysis (e.g., "Snowflake, Inc."). Pair with context_type=Displacement to surface companies moving off that vendor; shows displacement signals and context dispositions.
product_name	string	❌ No	-	Filter by product name (e.g., "Salesforce Sales Cloud"). Scopes results to intent signals related to this product.
intent_level	string	❌ No	-	Filter by intent level.
buyers_journey	string	❌ No	-	Filter by buyer journey stage (e.g., "Researching", "Evaluating", "Purchasing").
context_type	string	❌ No	-	Filter by context type (e.g., "Whitespace", "Expansion", "Displacement", "Complementary").
source	string	❌ No	-	Filter by data source. Omit to include both HG and TrustRadius signals. Note: source="trustradius" topic scores currently return 0 — meaningful TrustRadius data is in the activities array, not scored topics; use source="hg" for scored topic signals.
start_date	string	❌ No	-	Start date in YYYY-MM-DD format. Defaults to 30 days ago.
end_date	string	❌ No	-	End date in YYYY-MM-DD format. Defaults to today.
signal	string	❌ No	-	Filter by signal category. Activates activity search mode. Values: comparison (view Comparison, click Comparisons), pricing (view Product Pricing), research (view Product Listing, view Category), evaluation (view Review, view Reviews and Ratings).
products	array	❌ No	-	Array of product names with AND logic — returns only companies/events matching ALL products (e.g., ["Databricks", "Snowflake Platform"]). Activates activity search mode. Distinct from product_name which filters the intent endpoint.
filters	object	❌ No	-	Firmographic and category filters for activity search mode.
filters.employees_range	string	❌ No	-	Employee range filter (e.g., "10,000+", "1,001-5,000", "201-500").
filters.country_codes	array	❌ No	-	ISO country code filter (e.g., ["US", "GB"]).
filters.category_name	string	❌ No	-	Filter by product category name.
group_by	string	❌ No	-	"company" for aggregated company data, omit for raw individual events with evidence URLs. Activates activity search mode. Note: group_by="company" combined with signal switches to cross-company activity search — companyDomain is ignored and the response follows a different schema (ranked companies, not a per-company lookup).
limit	integer	❌ No	-	Pagination limit (1-200). Used in both intent and activity search modes.
offset	integer	❌ No	-	Pagination offset (default 0). Used in both intent and activity search modes.

Required Integrations

• hginsights_v2

Use Cases

• What technology areas is a company researching right now? — top topics by score
• Is a company showing displacement signals against a competitor? — vendor_name + context_type=Displacement
• Which buyer journey stage is a company in for a topic area? — buyers_journey filter
• What high-intent signals does a company have recently? — intent_level=High + date range
• Show only HG proprietary intent signals for a company — source=hg

Example Usage

Top intent topics for a company

{
  "tool": "company_intent",
  "arguments": {
    "companyDomain": "cisco.com",
    "limit": 10
  }
}

Competitive displacement signals

{
  "tool": "company_intent",
  "arguments": {
    "companyDomain": "salesforce.com",
    "vendor_name": "Oracle Corporation",
    "context_type": "Displacement",
    "intent_level": "High"
  }
}

HG-only signals in a date window

{
  "tool": "company_intent",
  "arguments": {
    "companyDomain": "cisco.com",
    "source": "hg",
    "limit": 20
  }
}

Related Tools

intent_category, list_intent_topics, company_technographic, company_fai