Intent Topic Catalog (Resolver)
RESOLVER: discover valid intent topic names/IDs from the official HG Insights catalog. Intent topics are buying-signal themes companies research online (e.g. "Cloud Security", "ERP", "Salesforce Sales Cloud"). This tool ONLY lists/searches the topic vocabulary — it does not return any company or intent data.
Use this when: you need the exact spelling of a topic before filtering intent — i.e. discover valid topic names before feeding one into intent_category or company_intent. Always resolve topic names here rather than guessing; a bad guess elsewhere returns topic_matched:false and zero companies.
Query with a SINGLE keyword (e.g. 'security', 'cloud', 'ERP', 'Salesforce'). Multi-word descriptive phrases (e.g. 'cloud storage solution') return 0 results because the search matches catalog topic NAMES, not natural language. For broader coverage run several single-word queries with different keywords or word forms (e.g. 'cloud', then 'storage', then 'infrastructure').
Do NOT use this when:
- You want a specific company's top intent topics → use company_intent (company → its topics).
- You want the companies showing intent for a topic → use intent_category (topic → companies).
Credits
Free — No credits consumed. See the full credit table for how AI Credits work.
Parameters
| Name | Type | Default | Description |
|---|---|---|---|
query Required | string | - | REQUIRED. Single-keyword substring matched against catalog topic NAMES (e.g., 'security', 'cloud', 'ERP', 'Salesforce'). Returns the closest matching topic names/IDs sorted by relevance. WARNING: Multi-word descriptive phrases (e.g., 'cloud storage solution', 'data warehouse platform') return 0 results — this matches topic names, not natural language. To widen coverage, make several calls with different single-word keywords or word forms (e.g., 'cloud', then 'storage', then 'infrastructure'). |
is_tech | boolean | - | When true, return only technology-related intent topics. Omit to include all topic categories. |
limit | number | - | Maximum topic names to return (default 50). Raise to retrieve more matches; values above the 500-per-page size are fetched via pagination up to a 5000-topic cap. |
Required Integrations
This tool is only available when your organization has the following integration configured in the Phoenix Integrations settings:
- HG Insights (v2) (
hginsights_v2)
Use Cases
- Resolve a valid topic name before an intent query — query='security' (then pass a returned name to intent_category)
- Discover exact catalog spellings for a vendor or product theme — query='Salesforce'
- Browse technology-only intent topics — query='cloud' + is_tech=true
- Retrieve topic IDs to recommend real intent topics instead of guessing — query='ERP'
- Widen a broad theme by running several single-word passes — query='storage', then query='infrastructure'
Example Usage
Find intent topics matching a keyword
{
"tool": "list_intent_topics",
"arguments": {
"query": "security"
}
}
Technology-only topics, capped result set
{
"tool": "list_intent_topics",
"arguments": {
"query": "cloud",
"is_tech": true,
"limit": 25
}
}
Resolve a vendor topic spelling
{
"tool": "list_intent_topics",
"arguments": {
"query": "Salesforce"
}
}
Response Format
| Field | Type | Description |
|---|---|---|
count | number | Number of intent topics returned |
totalAvailable | number | Total number of intent topics matching the query |
topics | array | List of intent topic information |
topics[].id | string | Unique intent topic identifier |
topics[].name | string | Intent topic name |
topics[].category | string | Topic category |
topics[].is_tech_related | boolean | Whether this is a technology-related topic |