{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-v2/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Intent Signals","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"intent-signals","__idx":0},"children":["Intent Signals"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Intent signals tell you what a known company is actively researching right now. The HG API returns two complementary types of intent data from a single endpoint: HG Contextual Intent (topic-based signals derived from web content consumption) and ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://www.trustradius.com"},"children":["TrustRadius"]}," buyer activities (first-party behavioral signals from the TrustRadius review platform)."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"two-types-of-intent","__idx":1},"children":["Two Types of Intent"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"hg-contextual-intent-topics","__idx":2},"children":["HG Contextual Intent (Topics)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["HG processes nearly 2 billion intent records per week, monitoring web content consumption across 4,000+ B2B technology topics. When a company's employees repeatedly consume content about a topic — product reviews, comparison pages, how-to guides — HG registers a topic intent signal and contextualizes it against that company's known tech stack."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["What makes HG topic intent distinct: the signal isn't just \"researching Zero Trust\" — it's \"researching Zero Trust while already running a competing product,\" which changes the interpretation entirely. That context is surfaced via ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["context_type_names"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each topic signal includes:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["**name**"]}," — the topic being researched (e.g., ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"Zero Trust Architecture\""]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"Cloud Security Posture Management\""]},")"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["**score**"]}," — signal strength, 0–100"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["**signal_level**"]}," — ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["HIGH"]}," (score > 84) or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MEDIUM"]}," (score 60–84) based on volume, recency, and trajectory"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["**trend**"]}," — direction of signal change; positive = increasing activity"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["**buyers_journey_name**"]}," — ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Researching"]}," (early-stage, exploring options) or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Evaluating"]}," (actively comparing solutions)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["**context_type_names**"]}," — what kind of purchase this signal suggests (see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#context-types"},"children":["Context Types"]},")"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["**context_dispositions**"]}," — sentiment of the signal (e.g., ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POSITIVE"]},")"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["**last_seen_at**"]}," — most recent date a signal was observed"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["**product_names**"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["**vendor_names**"]}," — products and vendors associated with the signal"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["**location_strength**"]}," — geographic concentration of the signal (0–100)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["**source**"]}," — always ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["hg"]}," for topic signals"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"trustradius-buyer-activities","__idx":3},"children":["TrustRadius Buyer Activities"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://www.trustradius.com"},"children":["TrustRadius"]}," captures first-party behavioral data from real buyers on their product review platform. When someone from a company views a product page, reads reviews, or compares solutions on TrustRadius, it registers as a buyer activity. These are mid-to-bottom-of-funnel signals: the buyer has moved past awareness and is actively evaluating specific products."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each activity includes:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["**activity_type**"]}," — what the buyer did (e.g., ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"view\""]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"compare\""]},")"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["**activity_label**"]}," — human-readable description (e.g., ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"Product Details\""]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"Competitors\""]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"Review\""]},")"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["**activity_date**"]}," — when it happened"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["**daily_views**"]}," — how many times that day"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["**intent_signal_url**"]}," — direct link to the TrustRadius page that triggered the signal"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["**products**"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["**vendors**"]}," — what was being researched"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["**city_name**"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["**state_name**"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["**country_name**"]}," — approximate visitor location"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["When to use each:"]}," ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://www.trustradius.com"},"children":["TrustRadius"]}," activities are bottom-of-funnel — someone is actively in the product. HG topics are broader and earlier-stage across the full web. A company showing both in the same category is a high-confidence, high-urgency signal."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"account-level-use-cases","__idx":4},"children":["Account-Level Use Cases"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"validate-buying-stage-for-a-pipeline-account","__idx":5},"children":["Validate buying stage for a pipeline account"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Call ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/intent/enrich"]}," scoped to your category's ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["topic_ids"]},". If ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["buyers_journey_name"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Evaluating"]}," + ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["signal_level"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["HIGH"]},", the account is actively comparing solutions — highest urgency tier."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"check-competitive-displacement-exposure","__idx":6},"children":["Check competitive displacement exposure"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Filter ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["context_type_names: [\"Displacement\"]"]}," with a competitor's ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["vendor_ids"]},". If signals are present, the account is researching a replacement and timing is right for outreach. If no signals, note it and re-check next cycle."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"combine-both-sources-for-confidence","__idx":7},"children":["Combine both sources for confidence"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If an account shows HG topic signals AND ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://www.trustradius.com"},"children":["TrustRadius"]}," activities in the same category, treat it as a high-confidence in-market signal. Neither source alone is as strong as both together."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"cost-efficient-scanning-across-a-large-account-list","__idx":8},"children":["Cost-efficient scanning across a large account list"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fields: [\"summary\"]"]}," for a fast, free sweep across your full account list — no credits consumed. Identify which accounts have ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["high_signal_topics_count > 0"]}," or recent ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["latest_signal_date"]},", then drill into ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["topics"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["activities"]}," only for accounts that clear your threshold."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"endpoint","__idx":9},"children":["Endpoint"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"POST /data-api/v2/intent/enrich\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Returns intent signals for a single known company. Identify the company by ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["domain"]}," or HG ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]},". This is an enrichment endpoint — you already know which company you want; you're fetching the depth of their intent signals."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Looking to discover companies by intent? Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /data-api/v2/companies/search"]}," with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["filters.intent"]}," to find companies matching specific intent criteria across your addressable market. ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#finding-companies-by-intent"},"children":["See Finding Companies by Intent"]},"."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"estimate-credit-cost-first","__idx":10},"children":["Estimate Credit Cost First"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Intent data is credit-priced. Before calling ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/intent/enrich"]},", use the estimate endpoint with the same request body to see the cost — no credits consumed, no data returned."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"POST /data-api/v2/intent/enrich/estimate\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Response includes ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["credits_estimate"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["available_credits"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sufficient_credits"]},", and a per-section breakdown (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["topics"]}," vs ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["activities"]},"). If ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sufficient_credits"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["false"]},", narrow your request — filter to specific ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["topic_ids"]}," or drop ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["activities"]}," from ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fields"]},"."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"response-sections","__idx":11},"children":["Response Sections"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Three sections, all returned by default. Use the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fields"]}," array to request only what you need."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Section"},"children":["Section"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Contains"},"children":["Contains"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Credit cost"},"children":["Credit cost"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["summary"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Aggregate counts: active topics, high-signal topics, latest signal date, source breakdown, top context types"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Free — 0 credits"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["topics"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["HG Contextual Intent topic signals (paginated)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Charged per record"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["activities"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://www.trustradius.com"},"children":["TrustRadius"]}," buyer activity signals (paginated)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Charged per record"]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"filters","__idx":12},"children":["Filters"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Filters are scoped by section. The API enforces strict nesting — putting a filter in the wrong level returns a 422."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"global-filters-top-level-under-filters-","__idx":13},"children":["Global filters (top-level under ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["filters"]},")"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Filter"},"children":["Filter"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["filters.signal_date.min"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".max"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["date string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Narrow signals to a date range"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["filters.vendor_ids"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["integer[]"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Only signals related to these vendor IDs"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["filters.product_ids"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["integer[]"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Only signals related to these product IDs"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"topics-only-filters--filterstopics-","__idx":14},"children":["Topics-only filters (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["filters.topics"]},")"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Filter"},"children":["Filter"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Values"},"children":["Values"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["signal_level"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"HIGH\""]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"MEDIUM\""]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Filter by signal strength"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["buyers_journey_names"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"Researching\""]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"Evaluating\""]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Filter by buying stage"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["context_type_names"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"Displacement\""]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"Whitespace\""]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"Expansion\""]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"Complementary\""]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Filter by purchase context"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["topic_ids"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["hex string[]"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Scope to specific topic IDs — always use this in production (see note below)"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"activities-only-filters--filtersactivities-","__idx":15},"children":["Activities-only filters (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["filters.activities"]},")"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Filter"},"children":["Filter"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["product_category_ids"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["hex string[]"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Filter ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://www.trustradius.com"},"children":["TrustRadius"]}," activities by product category"]}]}]}]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Always filter by ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["topic_ids"]}," in production."]}," The catalog has 4,000+ topics. Without this filter, the response includes every topic the company has ever shown activity on — often hundreds of thousands of records and significant credit cost. Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /data-api/v2/catalog/intent_topics?name=<keyword>"]}," to find the IDs for your category first, then pass them here."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"context-types","__idx":16},"children":["Context Types"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Context types are HG's proprietary interpretation of what a topic signal means — derived by cross-referencing the intent signal against the company's known tech stack. Available on HG topic signals only."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Context Type"},"children":["Context Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"What it means"},"children":["What it means"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Displacement"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Company researching a product where HG detects a competing product already installed. Actively shopping for a replacement — highest urgency."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Whitespace"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Company researching a product in a category where no install is detected. Net-new capability purchase likely; may need more education."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Expansion"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Company researching a product from a vendor they already use. Likely expanding footprint within an existing relationship."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Complementary"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Company researching tools that work alongside their existing stack. Cross-sell signal."]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"pagination","__idx":17},"children":["Pagination"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["limit"]}," (default: 50, max: 200) and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["offset"]}," are request-level parameters — they apply uniformly to both ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["topics"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["activities"]}," sections."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"example-is-this-account-in-market-for-my-category","__idx":18},"children":["Example: Is this account in-market for my category?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before a sales call or before triggering an outreach sequence, check whether the account is actively researching topics in your category. Scope the request to your relevant topic IDs to control cost and get a clean signal. Get topic IDs from ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /data-api/v2/catalog/intent_topics?name=zero+trust"]}," first."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"Is HPE in-market for Zero Trust?\""]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X POST https://api.hginsights.com/data-api/v2/intent/enrich \\\n  -H \"Authorization: Bearer $HG_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"company\": { \"domain\": \"hpe.com\" },\n    \"fields\": [\"summary\", \"topics\"],\n    \"filters\": {\n      \"topics\": {\n        \"topic_ids\": [\n          \"C66928848C2664D99CBCABFE12D4871\",\n          \"2542E6789B273C51BE81F0000A669969\",\n          \"248F517588E2D6CC33535D3CA7802222\"\n        ],\n        \"signal_level\": [\"HIGH\", \"MEDIUM\"]\n      }\n    },\n    \"limit\": 10\n  }'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"company\": {\n    \"id\": \"...\",\n    \"name\": \"HEWLETT PACKARD ENTERPRISE COMPANY\",\n    \"domain\": \"hpe.com\"\n  },\n  \"summary\": {\n    \"active_topics_count\": 617904,\n    \"high_signal_topics_count\": 154571,\n    \"latest_signal_date\": \"2026-05-30\",\n    \"sources\": { \"hg\": 617904, \"trustradius\": 498 },\n    \"top_context_types\": {\n      \"Displacement\": 2233,\n      \"Expansion\": 13900,\n      \"Complementary\": 11386\n    }\n  },\n  \"topics\": {\n    \"count\": 17,\n    \"data\": [\n      {\n        \"id\": \"C66928848C2664D99CBCABFE12D4871\",\n        \"name\": \"Zero Trust Architecture\",\n        \"score\": 92,\n        \"signal_level\": \"HIGH\",\n        \"trend\": 0.0,\n        \"buyers_journey_name\": \"Researching\",\n        \"context_type_names\": [],\n        \"last_seen_at\": \"2026-05-16\",\n        \"state_name\": \"TX\",\n        \"country_name\": \"United States of America (the)\",\n        \"region_name\": \"AMER\",\n        \"location_strength\": 47,\n        \"vendor_names\": [],\n        \"product_names\": [],\n        \"source\": \"hg\"\n      }\n    ]\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["summary.active_topics_count"]}," reflects the company's total intent profile across all topics — not just your filter. Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["topics.count"]}," (17) to see how many matched."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"example-is-this-account-researching-products-in-my-category-on-trustradius","__idx":19},"children":["Example: Is this account researching products in my category on TrustRadius?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["TrustRadius activities reveal bottom-of-funnel behavior: a real buyer at the company is on the platform, reading competitor reviews or comparing products in a category. Scope to a specific product category using ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["filters.activities.product_category_ids"]}," — get category IDs from ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /data-api/v2/catalog/product_categories?name=<category>"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Data Security category ID (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["5416985E784F2637FF24841C8E141D5"]},") was retrieved from ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /data-api/v2/catalog/product_categories?name=data+security"]},"."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X POST https://api.hginsights.com/data-api/v2/intent/enrich \\\n  -H \"Authorization: Bearer $HG_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"company\": { \"domain\": \"hpe.com\" },\n    \"fields\": [\"activities\"],\n    \"filters\": {\n      \"signal_date\": { \"min\": \"2026-01-01\" },\n      \"activities\": {\n        \"product_category_ids\": [\"5416985E784F2637FF24841C8E141D5\"]\n      }\n    },\n    \"limit\": 3\n  }'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"company\": {\n    \"id\": \"17A5AD9E58706F10B0AE715432DC533E\",\n    \"name\": \"HEWLETT PACKARD ENTERPRISE COMPANY\",\n    \"domain\": \"hpe.com\"\n  },\n  \"activities\": {\n    \"count\": 2,\n    \"data\": [\n      {\n        \"activity_type\": \"view\",\n        \"activity_label\": \"Competitors\",\n        \"activity_date\": \"2026-05-30\",\n        \"daily_views\": 1,\n        \"intent_signal_url\": \"https://www.trustradius.com/products/seclore/competitors\",\n        \"products\": [\"Seclore\"],\n        \"vendors\": [\"Seclore Technology Pvt Ltd\"],\n        \"city_name\": \"Spring\",\n        \"state_name\": \"TX\",\n        \"country_name\": \"United States of America (the)\"\n      },\n      {\n        \"activity_type\": \"view\",\n        \"activity_label\": \"Product Details\",\n        \"activity_date\": \"2026-05-30\",\n        \"daily_views\": 1,\n        \"intent_signal_url\": \"https://www.trustradius.com/products/bitlocker-drive-encryption/reviews#1\",\n        \"products\": [\"BitLocker Drive Encryption\"],\n        \"vendors\": [\"Microsoft Corporation\"],\n        \"city_name\": \"Spring\",\n        \"state_name\": \"TX\",\n        \"country_name\": \"United States of America (the)\"\n      }\n    ]\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["count: 2"]}," — HPE had 2 Data Security activity records since January. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["activity_label: \"Competitors\""]}," on Seclore means the buyer viewed the competitor comparison page — actively evaluating alternatives in the category. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["activity_label: \"Product Details\""]}," on BitLocker means they reviewed that product's feature page. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["intent_signal_url"]}," links directly to the TrustRadius page that triggered each signal."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"example-displacement-intent-against-a-competitor","__idx":20},"children":["Example: Displacement intent against a competitor"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Filter by ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["context_type_names: [\"Displacement\"]"]}," with a competitor's ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["vendor_id"]}," to check whether an account is actively researching a replacement for that vendor's products. Get vendor IDs from ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /data-api/v2/catalog/vendors?name=<vendor>"]},"."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X POST https://api.hginsights.com/data-api/v2/intent/enrich \\\n  -H \"Authorization: Bearer $HG_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"company\": { \"domain\": \"hpe.com\" },\n    \"fields\": [\"topics\"],\n    \"filters\": {\n      \"vendor_ids\": [3011],\n      \"topics\": {\n        \"signal_level\": [\"HIGH\"],\n        \"context_type_names\": [\"Displacement\"]\n      }\n    },\n    \"limit\": 5\n  }'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["No topics returned → the account isn't showing active displacement intent for that vendor right now. No signal is also a signal."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"catalog-endpoints","__idx":21},"children":["Catalog Endpoints"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use these to discover valid IDs for filters:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"What you need"},"children":["What you need"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Endpoint"},"children":["Endpoint"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Intent topic IDs"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /data-api/v2/catalog/intent_topics?name=<keyword>"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Buyers journey values"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /data-api/v2/catalog/intent_buyers_journey"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Context type values"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /data-api/v2/catalog/intent_context_types"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Vendor IDs"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /data-api/v2/catalog/vendors?name=<vendor>"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Product IDs"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /data-api/v2/catalog/products?name=<product>"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"finding-companies-by-intent","__idx":22},"children":["Finding Companies by Intent"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /data-api/v2/companies/search"]}," with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["filters.intent"]}," to find companies that have active intent signals matching your criteria."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This is the inverse of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/intent/enrich"]},": instead of \"give me intent data for this company\", you're asking \"give me companies that have this intent.\""]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Two common patterns:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Search by HG topic"]}," — find companies researching a specific topic:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X POST https://api.hginsights.com/data-api/v2/companies/search \\\n  -H \"Authorization: Bearer $HG_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"filters\": {\n      \"intent\": {\n        \"topics\": {\n          \"ids\": [\"19861D3AC60455102792F87A33AF533F\"],\n          \"inclusion_method\": \"ANY_PRESENT\"\n        },\n        \"signal_score\": \"HIGH\"\n      }\n    }\n  }'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /data-api/v2/catalog/intent_topics?name=<keyword>"]}," to look up topic IDs."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Search by context type"]}," — find companies showing displacement or whitespace intent at a specific signal strength:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X POST https://api.hginsights.com/data-api/v2/companies/search \\\n  -H \"Authorization: Bearer $HG_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"filters\": {\n      \"intent\": {\n        \"context_type_ids\": {\n          \"ids\": [\"DEF456789012345678901234ABCDEF12\"],\n          \"inclusion_method\": \"ANY_PRESENT\"\n        },\n        \"signal_score\": \"HIGH\"\n      }\n    }\n  }'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /data-api/v2/catalog/intent_context_types"]}," to look up context type IDs."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"intent-filters-available-in-search","__idx":23},"children":["Intent filters available in search"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Filter"},"children":["Filter"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["topics"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["object"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Filter by intent topic IDs (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ids"]}," + ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["inclusion_method"]},")"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["signal_score"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MEDIUM"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["HIGH"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Minimum signal score. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MEDIUM"]}," = 65–84, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["HIGH"]}," = 85–100"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["context_type_ids"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["object"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Filter by context type IDs (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ids"]}," + ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["inclusion_method"]},")"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["buyers_journey_ids"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["object"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Filter by buyers journey stage IDs"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["location"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["object"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Filter by signal origin — ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["country_alpha2s"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["state_ids"]},", or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["region_names"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["number_of_cadences"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["integer"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Minimum number of signal cadences (repeat activity cycles)"]}]}]}]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Note:"]}," The search endpoint's intent filter supports HG topic signals only right now. To filter by ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://www.trustradius.com"},"children":["TrustRadius"]}," product activity (page views, comparisons), first find your target companies via search, then call ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /data-api/v2/intent/enrich"]}," on each company with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fields: [\"activities\"]"]},"."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]}]},"headings":[{"value":"Intent Signals","id":"intent-signals","depth":1},{"value":"Two Types of Intent","id":"two-types-of-intent","depth":2},{"value":"HG Contextual Intent (Topics)","id":"hg-contextual-intent-topics","depth":3},{"value":"TrustRadius Buyer Activities","id":"trustradius-buyer-activities","depth":3},{"value":"Account-Level Use Cases","id":"account-level-use-cases","depth":2},{"value":"Validate buying stage for a pipeline account","id":"validate-buying-stage-for-a-pipeline-account","depth":3},{"value":"Check competitive displacement exposure","id":"check-competitive-displacement-exposure","depth":3},{"value":"Combine both sources for confidence","id":"combine-both-sources-for-confidence","depth":3},{"value":"Cost-efficient scanning across a large account list","id":"cost-efficient-scanning-across-a-large-account-list","depth":3},{"value":"Endpoint","id":"endpoint","depth":2},{"value":"Estimate Credit Cost First","id":"estimate-credit-cost-first","depth":2},{"value":"Response Sections","id":"response-sections","depth":2},{"value":"Filters","id":"filters","depth":2},{"value":"Global filters (top-level under filters )","id":"global-filters-top-level-under-filters-","depth":3},{"value":"Topics-only filters ( filters.topics )","id":"topics-only-filters--filterstopics-","depth":3},{"value":"Activities-only filters ( filters.activities )","id":"activities-only-filters--filtersactivities-","depth":3},{"value":"Context Types","id":"context-types","depth":2},{"value":"Pagination","id":"pagination","depth":2},{"value":"Example: Is this account in-market for my category?","id":"example-is-this-account-in-market-for-my-category","depth":2},{"value":"Example: Is this account researching products in my category on TrustRadius?","id":"example-is-this-account-researching-products-in-my-category-on-trustradius","depth":2},{"value":"Example: Displacement intent against a competitor","id":"example-displacement-intent-against-a-competitor","depth":2},{"value":"Catalog Endpoints","id":"catalog-endpoints","depth":2},{"value":"Finding Companies by Intent","id":"finding-companies-by-intent","depth":2},{"value":"Intent filters available in search","id":"intent-filters-available-in-search","depth":3}],"frontmatter":{"seo":{"title":"Intent Signals"}},"lastModified":"2026-06-05T18:59:05.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/v2/guides/intent","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}