Skip to main content

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).

Parameters​

NameTypeRequiredDefaultDescription
querystring✅ Yes-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_techboolean❌ No-When true, return only technology-related intent topics. Omit to include all topic categories.
limitnumber❌ No-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​

  • 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"
  }
}

intent_category, company_intent, get_product_category