Skip to main content
GET
Get a single brand's summary (mentions + citations + ranking)

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.