curl --request GET \
--url https://data.otterly.ai/v1/reports/brand/{reportId}/user-analytics/pages \
--header 'Authorization: Bearer <token>'import requests
url = "https://data.otterly.ai/v1/reports/brand/{reportId}/user-analytics/pages"
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/pages', 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/pages",
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/pages"
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/pages")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://data.otterly.ai/v1/reports/brand/{reportId}/user-analytics/pages")
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"
],
"items": [
{
"path": "/us/running",
"domain": "adidas.com",
"host": "adidas.com",
"urlHash": "7394a2bb766646caa82a16a34a250b2449664fc51e5d76fada32505090d45f1c",
"totalVisits": 1286,
"sources": [
{
"source": "openai",
"visits": 812
},
{
"source": "perplexity",
"visits": 474
}
]
}
],
"paging": {
"limit": 25,
"offset": 0,
"totalCount": 236,
"hasMore": true
}
}{
"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"
}List pages visited by users for a brand report
Per-page breakdown of human visits measured by the User Analytics snippet, busiest page first, with a per-source split (which AI assistant sent the visitors). Pages are segmented per host: a subdomain’s pages are listed on their own, and domain says which of the report’s domains each belongs to. Without source the counts cover the AI assistants only, as in the app.
curl --request GET \
--url https://data.otterly.ai/v1/reports/brand/{reportId}/user-analytics/pages \
--header 'Authorization: Bearer <token>'import requests
url = "https://data.otterly.ai/v1/reports/brand/{reportId}/user-analytics/pages"
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/pages', 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/pages",
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/pages"
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/pages")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://data.otterly.ai/v1/reports/brand/{reportId}/user-analytics/pages")
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"
],
"items": [
{
"path": "/us/running",
"domain": "adidas.com",
"host": "adidas.com",
"urlHash": "7394a2bb766646caa82a16a34a250b2449664fc51e5d76fada32505090d45f1c",
"totalVisits": 1286,
"sources": [
{
"source": "openai",
"visits": 812
},
{
"source": "perplexity",
"visits": 474
}
]
}
],
"paging": {
"limit": 25,
"offset": 0,
"totalCount": 236,
"hasMore": true
}
}{
"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 - 50Optional. Case-insensitive substring match on the page host and path combined (<host><path>), up to 200 characters. Matched literally — % and _ are not wildcards. A full URL is accepted: a leading scheme, a www. host prefix, a host port and any query string or fragment are stripped before matching.
200Response
A page of visited pages 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"