> ## Documentation Index
> Fetch the complete documentation index at: https://docs.verseodin.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Metric glossary

> Plain-English definitions of every metric column the API exposes.

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`](/api-reference/discovery/list-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.

<ResponseField name="ai_coverage_over_time" type="number">
  Percentage of prompts where the AI mentioned your brand by name.
  `trust_cnt / n × 100`.
</ResponseField>

<ResponseField name="ai_trust_mentions" type="integer">
  Count of prompts where your brand was mentioned at least once.
</ResponseField>

<ResponseField name="ai_avg_trust_position" type="integer">
  1-indexed rank of your brand among all brands the AI mentioned,
  ordered by mention frequency.
</ResponseField>

<ResponseField name="ai_visibility_ranking" type="array">
  Top-N table of brands by mention frequency. Each entry has
  `brand_name`, `trust_mentions`, `share_of_voice`, `rank`.
</ResponseField>

<ResponseField name="ai_top_prompts_by_trust_mentions" type="array">
  Prompts that drove the most brand mentions. `prompt`, `mentions`, `rank`.
</ResponseField>

<ResponseField name="ai_visibility_index" type="array">
  Per-prompt blindspot view — appeared links, competitor brands shown.
</ResponseField>

<ResponseField name="ai_citations_ranked_urls" type="array">
  URLs cited in AI answers, ranked by frequency.
</ResponseField>

<ResponseField name="ai_competitive_analysis" type="array">
  Per-competitor coverage breakdown — `brand_name`, `coverage_pct`,
  `trust_mentions`.
</ResponseField>

<ResponseField name="ai_domain_citation_count" type="integer">
  Combined count of your-domain citations + your brand mentions across
  all prompts.
</ResponseField>

<ResponseField name="ai_citation_share" type="number">
  Percentage of prompts where the AI cited your domain or mentioned
  your brand.
</ResponseField>

<ResponseField name="ai_top3_cited_urls" type="array">
  Top-3 most-cited URLs of your own domain.
</ResponseField>

<ResponseField name="ai_top_domain_citations" type="array">
  Top domains cited by the AI (yours + competitors), with citation
  count and share.
</ResponseField>

<ResponseField name="ai_top_prompts_by_website_citations" type="array">
  Prompts where your website got the most citations.
</ResponseField>

## GEO Audit (12 columns)

Your domain's footprint in the AI's cited sources — independent of
brand mentions in prose.

<ResponseField name="geo_citations_over_time" type="number">
  Percentage of prompts where the AI cited your domain.
</ResponseField>

<ResponseField name="geo_total_citations" type="integer">
  Total prompts that cited your domain at least once.
</ResponseField>

<ResponseField name="geo_avg_citation_rank" type="integer">
  Your rank by citation count among competitors.
</ResponseField>

<ResponseField name="geo_top_domains_in_citations" type="array">
  Domains the AI cited most across all prompts.
</ResponseField>

<ResponseField name="geo_top_prompts_citing_my_domain" type="array">
  Prompts where your domain got cited the most.
</ResponseField>

<ResponseField name="geo_citation_index" type="array">
  Per-prompt citation breakdown.
</ResponseField>

<ResponseField name="geo_competitor_analysis" type="array">
  Per-competitor citation analysis — `brand_name`, `coverage_pct`,
  `prompt_count`.
</ResponseField>

<ResponseField name="geo_citation_share" type="number">
  Your citations as a percentage of all citations across all domains
  in the period.
</ResponseField>

<ResponseField name="geo_top3_cited_urls" type="array">
  Top-3 URLs of yours cited by the AI.
</ResponseField>

<ResponseField name="geo_prompts_vs_you_vs_competitors" type="array">
  Prompt-level table comparing your URL vs the highest-ranked
  competitor URL.
</ResponseField>

<ResponseField name="geo_top_citing_domains" type="array">
  Domains that cited you the most (AI source-ranking view).
</ResponseField>

<ResponseField name="geo_top_queries_citing_my_domain" type="array">
  Queries (prompts) where your domain shows up in citations most often.
</ResponseField>

## AEO Audit (13 columns)

How often the AI mentions your brand in its prose answers (regardless
of whether it cites a URL).

<ResponseField name="aeo_brand_mentions_over_time" type="number">
  Percentage of prompts where the AI mentioned your brand.
</ResponseField>

<ResponseField name="aeo_your_brand_mentions" type="integer">
  Total prompts where your brand was mentioned.
</ResponseField>

<ResponseField name="aeo_avg_mention_rank" type="integer">
  Your rank by mention count among competitors.
</ResponseField>

<ResponseField name="aeo_top_surfaces_mentioning_you" type="array">
  Top URLs/sources where your brand was mentioned.
</ResponseField>

<ResponseField name="aeo_top_prompts_driving_mentions" type="array">
  Prompts that drove the most brand mentions.
</ResponseField>

<ResponseField name="aeo_brand_mention_index" type="array">
  Per-prompt mention breakdown — was your brand mentioned, were
  competitors mentioned, in what order.
</ResponseField>

<ResponseField name="aeo_mention_share_over_time" type="array">
  Per-day mention share trend (used by the AEO chart).
</ResponseField>

<ResponseField name="aeo_total_mentions" type="integer">
  Total brand mentions across all prompts (sum of occurrences, not
  distinct prompts).
</ResponseField>

<ResponseField name="aeo_mention_share" type="number">
  Your mentions / your-domain-citation count normalised against the
  total mentions in the universe.
</ResponseField>

<ResponseField name="aeo_top3_urls_shown" type="array">
  Top-3 URLs the AI surfaced when answering prompts.
</ResponseField>

<ResponseField name="aeo_prompt_mentions_vs_you_vs_competitors" type="array">
  Per-prompt comparison of your-brand mentions vs competitor mentions.
</ResponseField>

<ResponseField name="aeo_top_surfaces_naming_your_brand" type="array">
  Top sources that name your brand.
</ResponseField>

<ResponseField name="aeo_top_prompts_mentioning_my_brand" type="array">
  Prompts that mention your brand most often.
</ResponseField>

## Monitors (4 columns)

Health metrics for the data pipeline itself.

<ResponseField name="monitors_daily_brand_mentions" type="number">
  Daily brand mention rate as a percentage of all prompts.
</ResponseField>

<ResponseField name="monitors_answer_coverage" type="integer">
  How many prompts had a non-empty AI answer.
</ResponseField>

<ResponseField name="monitors_citation_freshness" type="integer">
  Indicator of how recent the AI's cited sources are.
</ResponseField>

<ResponseField name="monitors_model_coverage" type="array">
  Per-engine answer-coverage breakdown.
</ResponseField>

## Prompts summary

<ResponseField name="prompts_rows" type="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`](/api-reference/prompts/list-prompts)
  instead.**
</ResponseField>