Synthesises a per-brand summary from the universe’s history
row — one entry per distinct brand drawn from
ai_visibility_ranking, ai_competitive_analysis, and
geo_competitor_analysis. The output includes the
universe owner’s own brand AND every competitor.
Each row carries:
brand_name — display name (preserves case from source)trust_mentions — count of prompts where the brand was mentionedshare_of_voice — share of total brand mentions in this universe (%)visibility_rank — 1-indexed rank by mention frequencyai_coverage_pct — % of prompts covering this brand (AI tab)geo_coverage_pct — % of prompts citing this brand’s domaingeo_prompt_count — count of prompts citing this brand’s domainSorted by visibility_rank ASC (rank 1 first), then
trust_mentions DESC.
If multiple history rows match the filters, the most recent one
is used; the response includes the resolved day + engine
so callers know exactly which row was consulted.
Generate a key at /dashboard/settings/api-keys. Pass it as
Authorization: Bearer vso_xxx on every request.
Universe UUID — see GET /universes.
Pin the query to a specific day (YYYY-MM-DD). Without this, returns the most recent day.
Filter to a single AI engine. Omit for all.
chatgpt, gemini, grok, claude