SNsnowseo
AI Tracker

Sources AI engines cite when answering about the brand

Changed on

Which sources AI answers cite for a team: ranked domains with citation counts and domain ratings, domain-type and page-type splits, per-platform citation and mention counts, and top sources. Opt into the heavier blocks with subreddits=true (cited Reddit communities and threads), timeseries=true (per-day citations per domain) and competitorSources=true. To see the exact answers that cited one source, follow up with ai_visibility_citation_source.

get/v3/ai-tracker/visibility/citations

Request

  • Base URL
    https://api.snowseo.com
  • URL
    https://api.snowseo.com/v3/ai-tracker/visibility/citations
  • Auth
    • HTTP bearer
    • or API key in header x-api-key

Query parameters

teamIdstring
platformstring

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

competitorstring

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

countrystring

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

startDatestring

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

endDatestring

YYYY-MM-DD

daysinteger

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

promptBrandstring

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

trackingstring

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

intentstring

Comma-separated prompt intents, or empty for all.

includePreviousstring

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

domainLimitstring

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

domainsstring

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

includeUrlStatsstring

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

topSourcesLimitstring

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

subredditsstring

Include cited subreddits and their threads. Defaults to false.

timeseriesstring

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

timeseriesDomainsstring

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

competitorSourcesstring

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

Response

Default Response

citationsobject

Changes

  • e077f2a9cb83Revision changes
    • breaking

      for the query request parameter days, default value 30 was added

    • warning

      for the query request parameter days, the min was set to 1.00

  • 9b5994c28ee2Revision changes
    • info

      added the new optional query request parameter domains

    • info

      added the new optional query request parameter timeseriesDomains