Intent by Topic (Companies)

Find WHICH COMPANIES are showing buyer intent for a specific topic, vendor, or product. Given one topic (e.g. "cloud security"), returns the ranked list of companies researching it — merged HG proprietary + TrustRadius signals with signal strength (0–100, where 100 = strongest), intent levels (High/Medium/Low), buyer journey stages, and context types. This is the INVERSE of company_intent: topic → companies here, vs. company → its top topics there.

Use this when: you have a topic/product/vendor and want the account list (topic → companies) — e.g. "which companies are researching Snowflake?", "who is in-market for ERP right now?", or building a target/ABM list from an intent theme. Narrow with vendor_name, product_name, intent_level, buyers_journey, context_type, source, or a date window.

Do NOT use this when:

• You have ONE company and want its top intent topics → use company_intent (company → its top topics).
• You do not yet know a valid topic name → call list_intent_topics FIRST to discover exact topic names/IDs (topic_name is fuzzy-matched, but a bad guess returns topic_matched:false and zero companies).

topic_name is REQUIRED. Passing signal, products, group_by, or filters switches this tool into activity-search mode (raw events / cross-company aggregates) and cannot be combined with the intent-only filters above.

Parameters

Name	Type	Required	Default	Description
topic_name	string	✅ Yes	-	REQUIRED. The topic/category whose intent-showing companies you want returned (e.g., "Siemens Teamcenter", "cloud security", "ERP"). Fuzzy-matched server-side; an unmatched guess yields topic_matched:false with zero companies, so call list_intent_topics first to get a valid name.
vendor_name	string	❌ No	-	Narrow the returned companies to those whose intent signals relate to this vendor (e.g., "Snowflake, Inc."). Pair with context_type=Displacement to find accounts moving off the vendor. Intent-mode only.
product_name	string	❌ No	-	Narrow the returned companies to those whose intent signals relate to this product (e.g., "Salesforce Sales Cloud"). Intent-mode only. Distinct from the products array, which activates activity-search mode.
intent_level	string	❌ No	-	Return only companies at this intent strength. Intent-mode only.
buyers_journey	string	❌ No	-	Return only companies at this buyer-journey stage (e.g., "Researching", "Evaluating", "Purchasing"). Intent-mode only.
context_type	string	❌ No	-	Return only companies with this context type (e.g., "Whitespace", "Expansion", "Displacement", "Complementary"). Intent-mode only.
source	string	❌ No	-	Restrict to one data source. Omit to merge both HG and TrustRadius signals. Intent-mode only.
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.
maxResults	integer	❌ No	50	Maximum number of intent-showing companies to return (1-200, default 50). Intent mode; limit overrides it when both are set.
signal	string	❌ No	-	Buyer-activity signal category to search for. Activates activity-search mode (raw events / aggregates), NOT the topic intent list. 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 intent mode.
filters	object	❌ No	-	Firmographic and category filters. Presence activates 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 per-company rows, omit for raw individual events with evidence URLs. Activates activity-search mode.
limit	integer	❌ No	-	Page size (1-200). Overrides maxResults when provided. Applies to both intent and activity-search modes.
offset	integer	❌ No	-	Zero-based pagination offset (default 0). Applies to both modes.

Required Integrations

• hginsights_v2

Use Cases

• Which companies are showing intent for a specific topic? — topic_name (topic → ranked companies)
• Build a target account list of companies in-market for a product — topic_name + product_name
• Find only high-intent accounts researching a topic — topic_name + intent_level=High
• Surface companies displacing a competitor in a topic area — topic_name + vendor_name + context_type=Displacement
• Limit intent-showing companies to a recent window — topic_name + start_date/end_date

Example Usage

Companies showing intent for a topic

{
  "tool": "intent_category",
  "arguments": {
    "topic_name": "cloud security",
    "maxResults": 25
  }
}

High-intent accounts for a vendor's product

{
  "tool": "intent_category",
  "arguments": {
    "topic_name": "Siemens Teamcenter",
    "vendor_name": "Siemens",
    "intent_level": "High"
  }
}

HG-only intent companies in a date window

{
  "tool": "intent_category",
  "arguments": {
    "topic_name": "ERP",
    "source": "hg",
    "start_date": "2026-01-01",
    "end_date": "2026-02-01"
  }
}

Related Tools

company_intent, list_intent_topics, search_companies, company_technographic