Skip to main content
The analytics tools give AI agents programmatic access to Rankahead’s core visibility intelligence. Use them to fetch top-level KPIs, surface answer gaps your brand is missing, understand which domains are being cited by LLMs, and analyze how your visibility trends over time across providers and topics.

​
get_dashboard

Returns top-level KPIs for your account, including visibility score, mention rate, share of voice, per-LLM scores, competitor comparisons, and answer gap summaries. This is the best starting point for an overview of your AI visibility posture. This tool takes no input parameters. 
{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "get_dashboard",
    "arguments": {}
  },
  "id": 1
}
​
visibilityScore
number
Overall visibility score from 0–100 across all tracked prompts and providers.
​
mentionRate
number
Percentage of prompt runs where your brand was mentioned in the LLM response.
​
shareOfVoice
number
Your brand’s share of mentions relative to all tracked competitors.
​
perLlmScores
object
Visibility score broken down per LLM provider (OpenAI, Anthropic, Google, Perplexity).
​
competitors
object[]
List of tracked competitors with their respective visibility metrics.
​
answerGaps
object
Summary counts of critical and moderate answer gaps detected across your prompts.

​
get_gaps

Returns answer gap analysis for your domain — topics and questions where LLMs are not citing or mentioning your brand. Results are segmented into critical and moderate gaps and include heatmap data for prioritization.
​
domainId
string
Optional domain ID to scope results to a specific tracked domain. Omit to return gaps across all domains.
{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "get_gaps",
    "arguments": {}
  },
  "id": 2
}
​
critical
object[]
High-priority gaps where your brand is absent from LLM responses on commercially important prompts.
​
moderate
object[]
Lower-priority gaps with less immediate impact but worth addressing.
​
heatmap
object
Grid data mapping gap severity across topics and LLM providers for visualization.

​
get_citations

Returns citation analysis showing which external domains are cited across LLM responses and which providers cite them. Use this tool to understand your citation footprint and identify high-value third-party sources that influence AI answers in your category.
​
promptId
string
Optional prompt ID to scope citation analysis to a single prompt. Omit to return citations across all prompts.
{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "get_citations",
    "arguments": {}
  },
  "id": 4
}
​
citations
object[]
List of cited domains, each with the number of times cited and which LLM providers cited them.
​
topSources
string[]
The most frequently cited domains, ranked by citation count across all providers.
Returns visibility trends grouped by topic over a configurable time window. Results include per-provider breakdowns so you can see whether your gains or losses are concentrated in a specific LLM.
​
days
number
default:"30"
Lookback window in days. Accepted values: 7, 30, 90. Defaults to 30.
​
provider
string
Filter results to a single LLM provider. Accepted values: OPENAI, ANTHROPIC, GOOGLE, PERPLEXITY. Omit to return all providers.
​
locale
string
Optional locale code (e.g. en-US) to filter trends by geographic market.
{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "get_trends",
    "arguments": {
      "days": 30
    }
  },
  "id": 6
}
​
topics
object[]
Trend data grouped by topic, each containing time-series visibility scores.
​
providerBreakdown
object
Per-provider visibility metrics for the selected time window.

​
get_prompt_analytics

Returns detailed visibility analytics for a single prompt over time, including share of voice history and mention rate trends. Use this to evaluate the impact of content changes or new citations on a specific question your brand is targeting.
​
promptId
string
required
The ID of the prompt to retrieve analytics for.
​
days
number
default:"30"
Lookback window in days. Defaults to 30.
{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "get_prompt_analytics",
    "arguments": {
      "promptId": "prm_02kxw9a1m7d3y",
      "days": 90
    }
  },
  "id": 8
}
​
visibilityTrend
object[]
Time-series visibility scores for this prompt over the selected window.
​
shareOfVoiceHistory
object[]
Historical share of voice data showing how your brand’s presence changed relative to competitors.
​
mentionRateHistory
object[]
Day-by-day mention rate for this prompt across all LLM providers.