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.

Credits

1 — 1 per 100 categories returned. See the full credit table for how AI Credits work.

Parameters

Name	Type	Default	Description
topic_name Required	string	-	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	-	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	-	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	-	Return only companies at this intent strength. Intent-mode only.
buyers_journey	string	-	Return only companies at this buyer-journey stage (e.g., "Researching", "Evaluating", "Purchasing"). Intent-mode only.
context_type	string	-	Return only companies with this context type (e.g., "Whitespace", "Expansion", "Displacement", "Complementary"). Intent-mode only.
source	string	-	Restrict to one data source. Omit to merge both HG and TrustRadius signals. Intent-mode only.
start_date	string	-	Start date in YYYY-MM-DD format. Defaults to 30 days ago.
end_date	string	-	End date in YYYY-MM-DD format. Defaults to today.
maxResults	integer	50	Maximum number of intent-showing companies to return (1-200, default 50). Intent mode; limit overrides it when both are set.
signal	string	-	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	-	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	-	Firmographic and category filters. Presence activates activity-search mode.
filters.employees_range	string	-	Employee range filter (e.g., "10,000+", "1,001-5,000", "201-500").
filters.country_codes	array	-	ISO country code filter (e.g., ["US", "GB"]).
filters.category_name	string	-	Filter by product category name.
group_by	string	-	"company" for aggregated per-company rows, omit for raw individual events with evidence URLs. Activates activity-search mode.
limit	integer	-	Page size (1-200). Overrides maxResults when provided. Applies to both intent and activity-search modes.
offset	integer	-	Zero-based pagination offset (default 0). Applies to both modes.

Required Integrations

This tool is only available when your organization has the following integration configured in the Phoenix Integrations settings:

• HG Insights (Unified API) (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"
  }
}

Response Format

Field	Type	Description
context	object	Query context including date range, sources queried, and resolved topic (intent mode)
context.date_range	object
context.date_range.start	string
context.date_range.end	string
context.source	string	Data sources queried
context.topic_resolved	object	The resolved topic. Absent when topic_matched is false.
context.topic_resolved.topic_id	string
context.topic_resolved.topic_name	string
context.topic_matched	boolean	False when the requested topic_name matched no known topic (companies will be empty). Absent when a topic resolved.
context.no_match_reason	string	Human-readable explanation when topic_matched is false, naming the unmatched topic.
context.generated_at	string
companies	array	Intent mode: companies with signal strength. Activity search mode (group_by=company): companies with event counts.
companies[].company_id	string
companies[].company_name	string | null
companies[].domain	string | null
companies[].signal_strength	number	Intent signal strength 0-100 (intent mode)
companies[].intent_level	string | null	High, Medium, or Low (intent mode)
companies[].buyers_journey	string | null
companies[].context_types	array
companies[].topics_matched	array
companies[].last_seen_at	string | null
companies[].source	string
companies[].employees_range	string	Activity search mode
companies[].event_count	number	Activity search mode
companies[].total_views	number	Activity search mode
companies[].last_activity_date	string	Activity search mode
companies[].products_compared	array	Activity search mode
companies[].vendors	array	Activity search mode
companies[].signals	array	Activity search mode
events	array	Individual activity events with evidence URLs (returned when group_by is omitted)
events[].activity_date	string
events[].activity_type	string
events[].activity_label	string
events[].signal	string
events[].daily_views	number
events[].product_names	array
events[].vendor_names	array
events[].category_name_trees	array
events[].intent_signal_url	string
events[].company_id	string
events[].company_name	string
events[].domain	string
pagination	object	Pagination details for result set
pagination.total	number
pagination.limit	number
pagination.offset	number
pagination.has_more	boolean

Related Tools

company_intent, list_intent_topics, search_companies, company_technographic