Skip to main content
GET
Sources AI engines cite when answering about the brand
Which sources AI answers cite: ranked domains with domain ratings, domain-type and page-type splits, and per-platform counts. Opt into subreddits, timeseries, and competitorSources; cap the domain list with domainLimit. search matches the cited domain before domainLimit is applied. To fetch specific domains, pass domains as a JSON array of hosts; domainsTotal still counts every cited domain. timeseriesDomains narrows the timeseries the same way, which otherwise carries every cited domain per day. 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.

domainLimit
string

Max cited-domain rows, 0 to omit them, or 'all'. Defaults to 50; rows are ordered by citations descending.

domains
string

JSON array of domains (e.g. ["example.com"]); keeps only those domain rows. domainsTotal still counts every cited domain.

Case-insensitive text matched against the cited domain. Applied before domainLimit; domainsTotal still counts every cited domain.

includeUrlStats
string

Include the per-URL breakdown on each domain row (~99% of a row). Defaults to false.

topSourcesLimit
string

Max entries in topSources, 0 to omit, or 'all'. Defaults to 25 - the full list is one entry per cited URL.

subreddits
string

Include cited subreddits and their threads. Defaults to false.

timeseries
string

Include per-day citations per domain. Defaults to false.

timeseriesDomains
string

JSON array of domains (e.g. ["example.com"]) to keep in the timeseries. Omit for every cited domain, which can be hundreds per day.

competitorSources
string

Include the per-competitor source breakdown. Defaults to false.

Response

Default Response

meta
object
citations
object