Skip to main content
Returns the brand’s AI visibility summary from the AI assistants listed in engines, each with the date of its last answer. Includes brand visibility %, citation share, sentiment, top 5 competitors, top 5 cited sources, and per-persona citation rates. Optionally filter personaCitationRates to a single persona. What the numbers mean:
  • brandVisibility, citationShare and avgBrandRank are ALL TIME: brandVisibility is the share of all answersAnalyzed AI answers that mention the brand. windowDays does not apply to them yet.
  • citationShare is the share of all URLs cited in those AI answers that point to the brand’s own website or profiles, all time.
  • topCompetitors[].mentionShare is each brand’s share of all brand mentions in the last windowDays; the row with isYourBrand is this brand.
  • topSources and personaCitationRates cover the last windowDays.
  • sentiment covers the last windowDays and counts only answers that mention the brand. sentiment.score is the average of those answers’ sentiment scores, each from -100 (negative) to +100 (positive); positiveCount, negativeCount and neutralCount split the same answers.
  • trackedQuestions is how many questions are tracked; scanProgress is set only while a scan is running.
Use this when the user asks:
  • “How visible am I across AI systems?”
  • “Am I winning the GEO war?”
  • “What competitors are beating me?”
  • “How does persona X see my brand?”
Skip when the user wants the to-do list (use get_geo_priorities) or full brand identity (use get_brand_context). Response shape: { windowDays, brandVisibility, citationShare, avgBrandRank, trackedQuestions, answersAnalyzed, engines[{ code, name, lastResultAt }], scanProgress, sentiment, topCompetitors[], topSources[], personaCitationRates[], lastAnalysisAt }. Deprecated, kept for existing readers: totalPrompts and completedPrompts (now the tracked-question count, or scan progress while a scan runs) and topCompetitors[].visibility (same as mentionShare). Example: calling with { windowDays: 7, persona: “SMB founder” } narrows the persona section to matches of “SMB founder” (case-insensitive).

​
Inputs