Skip to main content
GET
/
universes
/
{id}
/
brands
/
{brand}
Get a single brand's summary (mentions + citations + ranking)
curl --request GET \
  --url https://verseodin.com/api/v1/universes/{id}/brands/{brand} \
  --header 'Authorization: Bearer <token>'
{
  "data": {
    "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,
    "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

​
id
string<uuid>
required

Universe UUID — see GET /universes.

​
brand
string
required

Brand identifier to look up — typically the domain (semrush.com) or the brand name string as it appears in ai_visibility_ranking[].brand_name. URL-encode if it contains characters needing escape (slashes, spaces).

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

OK

​
data
object

Synthesised per-brand summary built from the universe's latest history row. The response of /universes/{id}/brands is an array of these; /universes/{id}/brands/{brand} is one of them.