List brands tracked in a universe (mentions + citations + ranking)

curl --request GET \
  --url https://verseodin.com/api/v1/universes/{id}/brands \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {
      "brand_name": "verseodin.com",
      "trust_mentions": 42,
      "share_of_voice": 18.7,
      "visibility_rank": 1,
      "ai_coverage_pct": 32.5,
      "geo_coverage_pct": 12,
      "geo_prompt_count": 60
    },
    {
      "brand_name": "semrush.com",
      "trust_mentions": 25,
      "share_of_voice": 11.2,
      "visibility_rank": 2,
      "ai_coverage_pct": 19.3,
      "geo_coverage_pct": 7.4,
      "geo_prompt_count": 37
    },
    {
      "brand_name": "tryprofound.com",
      "trust_mentions": 14,
      "share_of_voice": 6.3,
      "visibility_rank": 3,
      "ai_coverage_pct": 11,
      "geo_coverage_pct": 3.1,
      "geo_prompt_count": 16
    }
  ],
  "day": "2026-04-27",
  "engine": "chatgpt"
}

Brands

List brands tracked in a universe (mentions + citations + ranking)

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 mentioned
share_of_voice — share of total brand mentions in this universe (%)
visibility_rank — 1-indexed rank by mention frequency
ai_coverage_pct — % of prompts covering this brand (AI tab)
geo_coverage_pct — % of prompts citing this brand’s domain
geo_prompt_count — count of prompts citing this brand’s domain

Sorted 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.

GET

universes

{id}

brands

List brands tracked in a universe (mentions + citations + ranking)

curl --request GET \
  --url https://verseodin.com/api/v1/universes/{id}/brands \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {
      "brand_name": "verseodin.com",
      "trust_mentions": 42,
      "share_of_voice": 18.7,
      "visibility_rank": 1,
      "ai_coverage_pct": 32.5,
      "geo_coverage_pct": 12,
      "geo_prompt_count": 60
    },
    {
      "brand_name": "semrush.com",
      "trust_mentions": 25,
      "share_of_voice": 11.2,
      "visibility_rank": 2,
      "ai_coverage_pct": 19.3,
      "geo_coverage_pct": 7.4,
      "geo_prompt_count": 37
    },
    {
      "brand_name": "tryprofound.com",
      "trust_mentions": 14,
      "share_of_voice": 6.3,
      "visibility_rank": 3,
      "ai_coverage_pct": 11,
      "geo_coverage_pct": 3.1,
      "geo_prompt_count": 16
    }
  ],
  "day": "2026-04-27",
  "engine": "chatgpt"
}

Authorizations

Authorization

string

header

required

Generate a key at /dashboard/settings/api-keys. Pass it as Authorization: Bearer vso_xxx on every request.

Path Parameters

string<uuid>

required

Universe UUID — see GET /universes.

Query Parameters

day

string<date>

Pin the query to a specific day (YYYY-MM-DD). Without this, returns the most recent day.

engine

enum<string>

Filter to a single AI engine. Omit for all.

Available options:

chatgpt,

gemini,

grok,

claude

Response

data

object[]

Show child attributes

day

string<date> | null

engine

string | null

Get a single prompt by UUID (cross-universe)Get a single brand's summary (mentions + citations + ranking)