get_topical_authority

​

What it does

​

When to use

• “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]?”

​

When not to use

• The user wants a paid-ads-specific view — use get_paid_ads_insights.
• The user wants a recommended to-do list — use get_geo_priorities.
• The user wants past actions and outcome deltas — use get_action_outcome_history.

​

Inputs

​

Response

{
  "citationRate": [
    { "isYou": true, "brand": "Citable", "value": 0.42 },
    { "isYou": false, "brand": "Profound", "value": 0.31 }
  ],
  "mentionRate": [
    { "isYou": true, "brand": "Citable", "value": 0.58 }
  ],
  "averageRank": [
    { "isYou": true, "brand": "Citable", "value": 2.3 }
  ],
  "sentiment": [
    { "isYou": true, "brand": "Citable", "value": { "score": 0.71, "sampleSize": 84, "confidence": "high" } }
  ],
  "tierGated": false,
  "scope": {
    "stages": ["awareness_discovery", "consideration_evaluation", "purchase_intent", "support_usage"],
    "isBranded": false,
    "competitorNames": ["Profound"],
    "modelCodes": ["chatgpt", "perplexity"],
    "personaNames": [],
    "days": 7,
    "appliedTier": "grow"
  }
}

​

Notes

• isBranded default is false — non-branded prompts only — because non-branded is the recommendation-relevant scope. Passing true on a non-Grow brand returns the own-brand row with tierGated: true and no competitor rows.
• Per-competitor averageRank and sentiment rows may be own-brand-only in some windows depending on sample size; citationRate and mentionRate always have full competitor breakdowns.