curl --request GET \
--url https://api.snowseo.com/v3/ai-tracker/visibility/citations \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.snowseo.com/v3/ai-tracker/visibility/citations"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.snowseo.com/v3/ai-tracker/visibility/citations', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.snowseo.com/v3/ai-tracker/visibility/citations",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.snowseo.com/v3/ai-tracker/visibility/citations"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.snowseo.com/v3/ai-tracker/visibility/citations")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.snowseo.com/v3/ai-tracker/visibility/citations")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"meta": {
"teamInfo": {},
"appliedFilters": {},
"totalPrompts": 123,
"activePrompts": 123,
"activeRegionRuns": 123,
"totalResponses": 123,
"promptStatus": {}
},
"citations": {}
}{
"success": true,
"error": "<string>",
"code": "<string>",
"message": "<string>",
"reference": "<string>"
}{
"success": true,
"error": "<string>",
"code": "<string>",
"message": "<string>",
"reference": "<string>"
}{
"success": true,
"error": "<string>",
"code": "<string>",
"message": "<string>",
"reference": "<string>"
}Citations
Which sources AI answers cite.
curl --request GET \
--url https://api.snowseo.com/v3/ai-tracker/visibility/citations \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.snowseo.com/v3/ai-tracker/visibility/citations"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.snowseo.com/v3/ai-tracker/visibility/citations', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.snowseo.com/v3/ai-tracker/visibility/citations",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.snowseo.com/v3/ai-tracker/visibility/citations"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.snowseo.com/v3/ai-tracker/visibility/citations")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.snowseo.com/v3/ai-tracker/visibility/citations")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"meta": {
"teamInfo": {},
"appliedFilters": {},
"totalPrompts": 123,
"activePrompts": 123,
"activeRegionRuns": 123,
"totalResponses": 123,
"promptStatus": {}
},
"citations": {}
}{
"success": true,
"error": "<string>",
"code": "<string>",
"message": "<string>",
"reference": "<string>"
}{
"success": true,
"error": "<string>",
"code": "<string>",
"message": "<string>",
"reference": "<string>"
}{
"success": true,
"error": "<string>",
"code": "<string>",
"message": "<string>",
"reference": "<string>"
}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
Your SnowSEO API key (sk_...).
Query Parameters
Comma-separated AI platform names, or 'All Platforms' for no filter.
Comma-separated competitor names, or 'All Competitors' for no filter. Keeps prompts where ANY listed competitor appears.
Comma-separated ISO2 country codes, or 'All Countries' for no filter.
YYYY-MM-DD. Omit with endDate set for All Time (from the first answer, no previous-period comparison).
YYYY-MM-DD
Days back from today on the team's calendar, converted to startDate/endDate. Ignored when startDate or endDate is set. Defaults to 30.
x >= 1'branded', 'unbranded', or 'all'.
'tracked', 'untracked', or empty for both.
Comma-separated prompt intents, or empty for all.
Include previous-period comparison values alongside each data point (roughly doubles the time-series payload). Defaults to false.
Max cited-domain rows, 0 to omit them, or 'all'. Defaults to 50; rows are ordered by citations descending.
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.
Include the per-URL breakdown on each domain row (~99% of a row). Defaults to false.
Max entries in topSources, 0 to omit, or 'all'. Defaults to 25 - the full list is one entry per cited URL.
Include cited subreddits and their threads. Defaults to false.
Include per-day citations per domain. Defaults to false.
JSON array of domains (e.g. ["example.com"]) to keep in the timeseries. Omit for every cited domain, which can be hundreds per day.
Include the per-competitor source breakdown. Defaults to false.
Was this page helpful?

