Skip to main content

Company Intent

Retrieve buyer intent signals from TrustRadius for a specific company, with detailed scoring, category analysis, and signal strength.

Parameters​

NameTypeRequiredDefaultDescription
companyDomainstringYessalesforce.comCompany domain to look up intent signals for (e.g., "cisco.com").
hg_idstringNo-HG Insights company ID (32 alphanumeric characters). When provided, overrides companyDomain.
start-datestringNo30 days agoStart date for intent data query in YYYY-MM-DD format.
end-datestringNoTodayEnd date for intent data query in YYYY-MM-DD format.

Required Integrations​

  • trustradius_intent

Use Cases​

  • Sales timing optimization
  • Interest and buying signal detection
  • Lead prioritization and qualification
  • Competitive intelligence

Example Usage​

Basic lookup​

{
  "tool": "company_intent",
  "parameters": {
    "companyDomain": "cisco.com"
  }
}

With custom date range​

{
  "tool": "company_intent",
  "parameters": {
    "companyDomain": "salesforce.com",
    "start-date": "2025-09-01",
    "end-date": "2025-09-30"
  }
}

Lookup by HG ID​

{
  "tool": "company_intent",
  "parameters": {
    "hg_id": "0FF69D9F596504A1FF4FF5B16FF"
  }
}

Response Format​

The tool returns a structured JSON response with:

  • companyDomain: The queried domain
  • window: Date range (start, end)
  • account: Company account info (id, name, sizeBand, industry, country) — if found
  • intentSummary: Aggregated scoring with primaryCategory, overallScore (0-1), and per-category breakdown
  • signals: Individual intent signals with timestamp, action, category, product, vendor, evidenceUrl, weight, recencyDays, score, and humanReason
  • features: Computed features (uniqueProducts, uniqueVendors, hasPricing, comparisonCount, listingViews, lastActivityDaysAgo)

Error Handling​

Common errors:

  • Missing Integration: TrustRadius Intent API key not configured (requires trustradius_intent integration)
  • Authentication Error: Invalid TrustRadius API key
  • Rate Limit: API rate limit exceeded
  • intent_category - Get intent signals by product category (across all accounts)
  • company_firmographic - Get company details
  • company_technographic - Analyze company tech stack

Next Steps​