Skip to main content
GET
AI visibility overview (leaderboard, trends, comparison)
The full dashboard payload: brand leaderboard, brand-visibility and share-of-voice trends, sentiment split, per-platform rollups, and the you-vs-average-competitor comparison. Cap the leaderboard with topBrands. Time series are columnar - a shared dates array plus one numeric array per series - rather than one object per day. The sentiment split comes as sentiment.shares and sentiment.changes, and the comparison rows as performanceRows keyed by metric. chartSeed holds your brand’s chart color, the competitor list that orders series colors, and the series keys your brand uses on each chart. 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.

includePrevious
string

Include previous-period comparison values alongside each data point (roughly doubles the time-series payload). Defaults to false.

topBrands
string

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

seriesLimit
string

Max brands to plot on the trend charts, or 'all'. Defaults to whatever topBrands is, which is what you want unless you need the full leaderboard alongside only a few chart lines.

Response

Default Response

meta
object
overview
object