Skip to main content
GET
Get Share of Voice
Returns share of voice data for your brand and competitors over a specified date range. Share of voice measures how often each brand is mentioned relative to all brands in AI responses.

Parameters

string
required
Bearer token. Format: Bearer slat_<your-token>.
integer
Number of days for the analysis window (e.g., 7, 30, 90). Range: 1–365. Default: 30.
number
Filter by topic ID.
string[]
Filter by one or more platforms: CHATGPT, PERPLEXITY, GOOGLE_AI_OVERVIEW, GOOGLE_AI_MODE, GEMINI, CLAUDE.

Response

Returns 200 OK with a JSON array of up to 100 entity objects: your brand first when it’s mentioned, then other entities by share of voice, highest first. Each object has these fields:
integer
required
Number of query runs that mentioned the entity.
integer
required
Average position in AI responses, rounded to a whole number.
integer
required
Visibility score (0–100), rounded to a whole number.
string
required
Brand or competitor name.
string
required
One of: BRAND, COMPETITOR, OTHER.
number
required
Share of voice percentage.

Example

Response

Status codes

What’s next