Get Citations
curl --request GET \
--url https://api.slatehq.ai/ai-analytics-service/api/public/v1/analytics/citations \
--header 'Authorization: <authorization>'import requests
url = "https://api.slatehq.ai/ai-analytics-service/api/public/v1/analytics/citations"
headers = {"Authorization": "<authorization>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<authorization>'}};
fetch('https://api.slatehq.ai/ai-analytics-service/api/public/v1/analytics/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.slatehq.ai/ai-analytics-service/api/public/v1/analytics/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: <authorization>"
],
]);
$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.slatehq.ai/ai-analytics-service/api/public/v1/analytics/citations"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "<authorization>")
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.slatehq.ai/ai-analytics-service/api/public/v1/analytics/citations")
.header("Authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.slatehq.ai/ai-analytics-service/api/public/v1/analytics/citations")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = '<authorization>'
response = http.request(request)
puts response.read_body{
"domain": "<string>",
"url": "<string>",
"title": "<string>",
"mentions": 123,
"date": "<string>",
"platform": "<string>",
"position": 123,
"category": "<string>"
}Analytics
Get Citations
Retrieve citation sources referenced by AI platforms in their responses.
GET
/
ai-analytics-service
/
api
/
public
/
v1
/
analytics
/
citations
Get Citations
curl --request GET \
--url https://api.slatehq.ai/ai-analytics-service/api/public/v1/analytics/citations \
--header 'Authorization: <authorization>'import requests
url = "https://api.slatehq.ai/ai-analytics-service/api/public/v1/analytics/citations"
headers = {"Authorization": "<authorization>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<authorization>'}};
fetch('https://api.slatehq.ai/ai-analytics-service/api/public/v1/analytics/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.slatehq.ai/ai-analytics-service/api/public/v1/analytics/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: <authorization>"
],
]);
$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.slatehq.ai/ai-analytics-service/api/public/v1/analytics/citations"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "<authorization>")
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.slatehq.ai/ai-analytics-service/api/public/v1/analytics/citations")
.header("Authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.slatehq.ai/ai-analytics-service/api/public/v1/analytics/citations")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = '<authorization>'
response = http.request(request)
puts response.read_body{
"domain": "<string>",
"url": "<string>",
"title": "<string>",
"mentions": 123,
"date": "<string>",
"platform": "<string>",
"position": 123,
"category": "<string>"
}Returns citation data from AI platform responses. Citations are the URLs and sources that AI models reference when generating answers to your tracked prompts.
Parameters
string
required
Bearer token. Format:
Bearer slat_<your-token>.string
Number of days to include (e.g.,
30). Range: 1–365. Default: 30.number
Filter by topic ID.
string[]
Filter by one or more platforms:
CHATGPT, PERPLEXITY, GOOGLE_AI_OVERVIEW, GOOGLE_AI_MODE, GEMINI, CLAUDE.Response
Returns200 OK with a JSON array of up to 5,000 citation objects, newest date first. Each object covers one URL, date, platform, and category. Each object has these fields:
string
required
Domain of the cited source.
string
required
Full URL of the cited page.
string
Page title of the cited source.
integer
required
Number of times the URL was cited on that date and platform.
string
required
Date the citation was recorded. Format:
YYYY-MM-DD.string
required
AI platform that cited the source.
integer
Average position of the citation in AI responses, rounded to a whole number.
string
Citation category. Values include
OWNED, MENTIONED, COMPETITOR, SOCIAL, NOT_MENTIONED, and OTHER.Example
curl -s "https://api.slatehq.ai/ai-analytics-service/api/public/v1/analytics/citations?dateRange=30&topicId=42" \
-H "Authorization: Bearer slat_YOUR_TOKEN"
import requests
response = requests.get(
"https://api.slatehq.ai/ai-analytics-service/api/public/v1/analytics/citations",
headers={
"Authorization": "Bearer slat_YOUR_TOKEN",
},
params={
"dateRange": "30",
"topicId": 42,
},
)
citations = response.json()
for c in citations:
print(c["domain"], c["mentions"], c["category"])
const params = new URLSearchParams({
dateRange: "30",
topicId: "42",
});
const response = await fetch(
`https://api.slatehq.ai/ai-analytics-service/api/public/v1/analytics/citations?${params}`,
{
headers: {
"Authorization": "Bearer slat_YOUR_TOKEN",
},
}
);
const citations = await response.json();
console.log(citations.length, "citations found");
Response
[
{
"domain": "example.com",
"url": "https://example.com/pm-tools-comparison",
"title": "Best Project Management Tools 2026",
"mentions": 15,
"date": "2026-02-11",
"platform": "CHATGPT",
"position": 1,
"category": "OWNED"
},
{
"domain": "techreview.com",
"url": "https://techreview.com/project-management-guide",
"title": "The Complete Guide to PM Software",
"mentions": 8,
"date": "2026-02-11",
"platform": "PERPLEXITY",
"position": 2,
"category": "MENTIONED"
}
]
Status codes
| Status | Description |
|---|---|
200 | Citations returned. |
400 | A filter is invalid, such as an unsupported platform or dateRange outside 1–365. |
401 | Missing or invalid Bearer token. See Authentication. |
500 | Internal server error. |
503 | The analytics store is temporarily unavailable (analytics store unavailable). |
What’s next
- Get Trends — View visibility trends over time.
- Get Overall Sentiment — Analyze sentiment in AI mentions.
Was this page helpful?