Skip to main content
The API exposes 40+ metric columns from the history table. They group into four families that map onto the four dashboard tabs. Use GET /api/v1/metrics to get the canonical list at runtime.

​
AI Visibility (15 columns)

How often your brand is mentioned and ranked when AI assistants answer prompts.
​
ai_coverage_over_time
number
Percentage of prompts where the AI mentioned your brand by name. trust_cnt / n × 100.
​
ai_trust_mentions
integer
Count of prompts where your brand was mentioned at least once.
​
ai_avg_trust_position
integer
1-indexed rank of your brand among all brands the AI mentioned, ordered by mention frequency.
​
ai_visibility_ranking
array
Top-N table of brands by mention frequency. Each entry has brand_name, trust_mentions, share_of_voice, rank.
​
ai_top_prompts_by_trust_mentions
array
Prompts that drove the most brand mentions. prompt, mentions, rank.
​
ai_visibility_index
array
Per-prompt blindspot view — appeared links, competitor brands shown.
​
ai_citations_ranked_urls
array
URLs cited in AI answers, ranked by frequency.
​
ai_competitive_analysis
array
Per-competitor coverage breakdown — brand_name, coverage_pct, trust_mentions.
​
ai_domain_citation_count
integer
Combined count of your-domain citations + your brand mentions across all prompts.
​
ai_citation_share
number
Percentage of prompts where the AI cited your domain or mentioned your brand.
​
ai_top3_cited_urls
array
Top-3 most-cited URLs of your own domain.
​
ai_top_domain_citations
array
Top domains cited by the AI (yours + competitors), with citation count and share.
​
ai_top_prompts_by_website_citations
array
Prompts where your website got the most citations.

​
GEO Audit (12 columns)

Your domain’s footprint in the AI’s cited sources — independent of brand mentions in prose.
​
geo_citations_over_time
number
Percentage of prompts where the AI cited your domain.
​
geo_total_citations
integer
Total prompts that cited your domain at least once.
​
geo_avg_citation_rank
integer
Your rank by citation count among competitors.
​
geo_top_domains_in_citations
array
Domains the AI cited most across all prompts.
​
geo_top_prompts_citing_my_domain
array
Prompts where your domain got cited the most.
​
geo_citation_index
array
Per-prompt citation breakdown.
​
geo_competitor_analysis
array
Per-competitor citation analysis — brand_name, coverage_pct, prompt_count.
​
geo_citation_share
number
Your citations as a percentage of all citations across all domains in the period.
​
geo_top3_cited_urls
array
Top-3 URLs of yours cited by the AI.
​
geo_prompts_vs_you_vs_competitors
array
Prompt-level table comparing your URL vs the highest-ranked competitor URL.
​
geo_top_citing_domains
array
Domains that cited you the most (AI source-ranking view).
​
geo_top_queries_citing_my_domain
array
Queries (prompts) where your domain shows up in citations most often.

​
AEO Audit (13 columns)

How often the AI mentions your brand in its prose answers (regardless of whether it cites a URL).
​
aeo_brand_mentions_over_time
number
Percentage of prompts where the AI mentioned your brand.
​
aeo_your_brand_mentions
integer
Total prompts where your brand was mentioned.
​
aeo_avg_mention_rank
integer
Your rank by mention count among competitors.
​
aeo_top_surfaces_mentioning_you
array
Top URLs/sources where your brand was mentioned.
​
aeo_top_prompts_driving_mentions
array
Prompts that drove the most brand mentions.
​
aeo_brand_mention_index
array
Per-prompt mention breakdown — was your brand mentioned, were competitors mentioned, in what order.
​
aeo_mention_share_over_time
array
Per-day mention share trend (used by the AEO chart).
​
aeo_total_mentions
integer
Total brand mentions across all prompts (sum of occurrences, not distinct prompts).
​
aeo_mention_share
number
Your mentions / your-domain-citation count normalised against the total mentions in the universe.
​
aeo_top3_urls_shown
array
Top-3 URLs the AI surfaced when answering prompts.
​
aeo_prompt_mentions_vs_you_vs_competitors
array
Per-prompt comparison of your-brand mentions vs competitor mentions.
​
aeo_top_surfaces_naming_your_brand
array
Top sources that name your brand.
​
aeo_top_prompts_mentioning_my_brand
array
Prompts that mention your brand most often.

​
Monitors (4 columns)

Health metrics for the data pipeline itself.
​
monitors_daily_brand_mentions
number
Daily brand mention rate as a percentage of all prompts.
​
monitors_answer_coverage
integer
How many prompts had a non-empty AI answer.
​
monitors_citation_freshness
integer
Indicator of how recent the AI’s cited sources are.
​
monitors_model_coverage
array
Per-engine answer-coverage breakdown.

​
Prompts summary

​
prompts_rows
array
Per-prompt summary used by the dashboard tables — {prompt, prompt_id, answer_mentioned, citation_mentioned, top_competitor, trend_pct}. For the full prompt + AI response text + citation URLs, use GET /universes/{id}/prompts instead.