Skip to main content
GET
AI visibility headline metrics
Track how often your brand appears in answers from AI assistants like ChatGPT, Perplexity, and Google’s AI Overviews. This is the data behind the dashboard’s AI Visibility tab - share of voice, prompt-level performance, citations, competitor comparisons, and sentiment.
You need AI Visibility set up for your brand with tracked prompts. Configure it from the AI Visibility dashboard.
The aggregate endpoints below accept the same scope filters (platform, competitor, country, startDate/endDate or days, promptBrand, tracking, intent) and return a meta object describing the team, the resolved window, and how many prompts and responses are behind the numbers. Omitting the date parameters gives you the last 30 days (see Date Windows). Send endDate without startDate for All Time: the series starts at the first answer and no previous-period comparison is returned. Detail and lookup endpoints (/v3/ai-tracker/visibility/prompts/{id}, /v3/ai-tracker/visibility/prompts?fields=minimal, /v3/ai-tracker/filter-options, /v3/ai-models) take fewer parameters and may omit meta; /v3/ai-tracker/visibility/brands/{name}, /v3/ai-tracker/visibility/citation-source, and /v3/ai-tracker/visibility/cited-subreddits take the scope filters but do not return meta. Pick the narrowest endpoint that answers your question - /v3/ai-tracker/visibility/summary is a few kilobytes, /v3/ai-tracker/visibility/overview grows with window length times tracked brands. Responses carry data only: percentages are numbers from 0 to 100, and there are no display colors, avatar initials or pre-formatted strings. Source and page types come as type keys (for example commercial). Previous-period comparison values are off by default on every endpoint that can produce them. They roughly double a time series and only a chart drawing a dotted comparison line reads them, so pass includePrevious=true when you need them. The scalar change fields are always included.

Summary

Headline numbers with daily sparklines and a change against the previous window: visibility, share of voice, citation share, and sentiment.

More endpoints

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.

Response

Default Response

meta
object
required
summaryCards
object
required
cards
object
required
sentimentEvidenceSummary
object