curl --request GET \
--url https://data.otterly.ai/v1/reports/brand/{reportId}/user-analytics/countries \
--header 'Authorization: Bearer <token>'import requests
url = "https://data.otterly.ai/v1/reports/brand/{reportId}/user-analytics/countries"
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/countries', 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/countries",
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/countries"
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/countries")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://data.otterly.ai/v1/reports/brand/{reportId}/user-analytics/countries")
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": [
{
"country": "us",
"visits": 2210
},
{
"country": "uk",
"visits": 684
},
{
"country": "de",
"visits": 512
},
{
"country": "zz",
"visits": 37
}
],
"paging": {
"limit": 25,
"offset": 0,
"totalCount": 18,
"hasMore": false
}
}{
"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 countries of users for a brand report
Per-country breakdown of human visits measured by the User Analytics snippet, busiest country first. Countries are lowercase ISO 3166-1 alpha-2 codes (uk for the United Kingdom); zz is the visits whose country is unknown. The codes returned here are what country accepts on the stats and pages endpoints. 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/countries \
--header 'Authorization: Bearer <token>'import requests
url = "https://data.otterly.ai/v1/reports/brand/{reportId}/user-analytics/countries"
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/countries', 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/countries",
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/countries"
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/countries")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://data.otterly.ai/v1/reports/brand/{reportId}/user-analytics/countries")
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": [
{
"country": "us",
"visits": 2210
},
{
"country": "uk",
"visits": 684
},
{
"country": "de",
"visits": 512
},
{
"country": "zz",
"visits": 37
}
],
"paging": {
"limit": 25,
"offset": 0,
"totalCount": 18,
"hasMore": false
}
}{
"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
A page of countries 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"