curl --request GET \
--url https://data.otterly.ai/v1/reports/brand/{reportId}/user-analytics/stats \
--header 'Authorization: Bearer <token>'import requests
url = "https://data.otterly.ai/v1/reports/brand/{reportId}/user-analytics/stats"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://data.otterly.ai/v1/reports/brand/{reportId}/user-analytics/stats', 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://data.otterly.ai/v1/reports/brand/{reportId}/user-analytics/stats",
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://data.otterly.ai/v1/reports/brand/{reportId}/user-analytics/stats"
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://data.otterly.ai/v1/reports/brand/{reportId}/user-analytics/stats")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://data.otterly.ai/v1/reports/brand/{reportId}/user-analytics/stats")
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{
"availability": "connected_with_data",
"startDate": "2026-09-23",
"endDate": "2026-10-06",
"domains": [
"adidas.com",
"blog.adidas.com"
],
"totalVisits": 4570,
"pagesVisited": 236,
"uniqueVisitors": 3107,
"topSource": "openai",
"sources": [
{
"source": "openai",
"visits": 2904
},
{
"source": "perplexity",
"visits": 1011
},
{
"source": "google",
"visits": 655
}
],
"trend": [
{
"dayId": "20261006",
"source": "openai",
"visitCount": 318
},
{
"dayId": "20261006",
"source": "perplexity",
"visitCount": 97
}
]
}{
"message": "Validation failed",
"target": "query",
"errors": [
{
"path": "country",
"message": "Required",
"code": "invalid_type"
}
]
}{
"message": "Report not found"
}{
"message": "Report not found"
}{
"message": "Report not found"
}Get user traffic overview for a brand report
Overview of human visitors to the brand report’s own domains, measured by the User Analytics snippet: total visits, unique visitors, distinct pages visited, the top source, per-source totals and a daily trend per source. A source is the AI assistant that sent the visitor (openai, perplexity, google, …), or other_external, direct_none, internal_self. Without source the totals cover the AI assistants only, as in the app. A named source replaces that set: source=direct_none is direct visits alone; repeat source to mix. Check availability before rendering — not_connected means no User Analytics site is set up for this report and the metrics are null, not zero.
curl --request GET \
--url https://data.otterly.ai/v1/reports/brand/{reportId}/user-analytics/stats \
--header 'Authorization: Bearer <token>'import requests
url = "https://data.otterly.ai/v1/reports/brand/{reportId}/user-analytics/stats"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://data.otterly.ai/v1/reports/brand/{reportId}/user-analytics/stats', 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://data.otterly.ai/v1/reports/brand/{reportId}/user-analytics/stats",
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://data.otterly.ai/v1/reports/brand/{reportId}/user-analytics/stats"
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://data.otterly.ai/v1/reports/brand/{reportId}/user-analytics/stats")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://data.otterly.ai/v1/reports/brand/{reportId}/user-analytics/stats")
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{
"availability": "connected_with_data",
"startDate": "2026-09-23",
"endDate": "2026-10-06",
"domains": [
"adidas.com",
"blog.adidas.com"
],
"totalVisits": 4570,
"pagesVisited": 236,
"uniqueVisitors": 3107,
"topSource": "openai",
"sources": [
{
"source": "openai",
"visits": 2904
},
{
"source": "perplexity",
"visits": 1011
},
{
"source": "google",
"visits": 655
}
],
"trend": [
{
"dayId": "20261006",
"source": "openai",
"visitCount": 318
},
{
"dayId": "20261006",
"source": "perplexity",
"visitCount": 97
}
]
}{
"message": "Validation failed",
"target": "query",
"errors": [
{
"path": "country",
"message": "Required",
"code": "invalid_type"
}
]
}{
"message": "Report not found"
}{
"message": "Report not found"
}{
"message": "Report not found"
}Authorizations
Path Parameters
Query Parameters
Optional. Keep only visits from these sources: an AI service (openai, perplexity, google, microsoft, anthropic, …), other_external (another website), direct_none (no referrer) or internal_self (another page of the site). Repeat the param for several, up to 50. Omitted, it means the AI assistants only, as in the app. Naming sources replaces that set: source=direct_none returns direct visits alone; repeat the param to mix AI and non-AI sources.
1 - 50Response
User traffic overview for the brand report.
Whether these numbers can be trusted. not_connected means no logs connector is active for this report — metrics are null, NOT zero, because nothing is being measured. connected_no_data means a connector is active but matched no visits in this window, so the zeros are real. connected_with_data means the payload is populated.
not_connected, connected_no_data, connected_with_data "connected_with_data"
Distinct visitors in the window (a visitor who returns on another day counts once; browsers that block storage are not counted). null when availability is not_connected, when the window starts more than about 13 months back (the raw events behind the count are kept 13 months), or when the count ran out of time. Narrow the window rather than retry.
x >= 0