Skip to main content
Returns the brand’s topical authority matrix — Citation Rate, Mention Rate, Average Rank, and Sentiment broken down per competitor — filterable by journey stage, persona, and AI model. Use this when the user asks:
  • “Where am I weakest on purchase-stage prompts?”
  • “Who’s beating me on comparison queries for the founder persona?”
  • “How does my Sentiment look across stages?”
  • “What’s my Citation Rate against [Competitor X]?”
Skip when the user wants a paid-ads-specific funnel (use get_paid_ads_insights) or a to-do list (use get_geo_priorities). Defaults: 7-day window, non-branded prompts only (isBranded=false), all four stages (awareness_discovery / consideration_evaluation / purchase_intent / support_usage), all personas, all models. Set ‘isBranded’ to true to query branded prompts — gated to the Grow plan; on any other plan only the own-brand row comes back, with tierGated=true. Response: { citationRate[], mentionRate[], averageRank[], sentiment[], tierGated, scope: { stages, isBranded, competitorNames, modelCodes, personaNames, days, appliedTier, appliedPlanName } }. Each metric array has one row per brand (yours + competitors) with isYou flag, brand name, and a numeric value (sentiment has { score, sampleSize, confidence }). Current limitation: per-competitor averageRank/sentiment rows are own-brand-only. appliedTier is the internal plan key. When you mention the plan, say appliedPlanName (e.g. “Optimize”). appliedPlanName is null for a workspace billed through a service provider: name no plan, and when tierGated is true say the branded comparison isn’t included rather than suggesting an upgrade.

​
Inputs