Skip to main content
GET
Brand leaderboard across the filtered dataset
Every brand seen in AI answers, ranked by mentions, with a leader / challenger / emerging split. Each segment lists brand names; the brand details are in rows. Cap with limit, or pass onlyYou=true for just your brand’s row. search matches the brand name and website before limit is applied, and total counts the matches. Scope filters are described on AI Visibility.

Authorizations

Authorization
string
header
required

Your SnowSEO API key (sk_...).

Query Parameters

teamId
string
platform
string

Comma-separated AI platform names, or 'All Platforms' for no filter.

competitor
string

Comma-separated competitor names, or 'All Competitors' for no filter. Keeps prompts where ANY listed competitor appears.

country
string

Comma-separated ISO2 country codes, or 'All Countries' for no filter.

startDate
string

YYYY-MM-DD. Omit with endDate set for All Time (from the first answer, no previous-period comparison).

endDate
string

YYYY-MM-DD

days
integer
default:30

Days back from today on the team's calendar, converted to startDate/endDate. Ignored when startDate or endDate is set. Defaults to 30.

Required range: x >= 1
promptBrand
string

'branded', 'unbranded', or 'all'.

tracking
string

'tracked', 'untracked', or empty for both.

intent
string

Comma-separated prompt intents, or empty for all.

limit
string

Max rows, or 'all'. Defaults to 25. Rows are ordered by mentions descending; the response reports total and truncated.

onlyYou
enum<string>

Return only your brand's row, ignoring limit. Defaults to false.

Available options:
true,
false

Case-insensitive text matched against the brand name and website. Applied before limit; total counts the matches.

Response

Default Response

meta
object
brands
object
total
number
truncated
boolean