Get brand analytics history
curl --request GET \
--url https://api.social-api.ai/v1/brands/{id}/analytics \
--header 'Authorization: <api-key>'const options = {method: 'GET', headers: {Authorization: '<api-key>'}};
fetch('https://api.social-api.ai/v1/brands/{id}/analytics', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.social-api.ai/v1/brands/{id}/analytics"
headers = {"Authorization": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": {
"from": "2026-08-21",
"series": [
{
"day_tz": "America/Los_Angeles",
"kind": "gauge",
"metric": "page_follows",
"points": [
{
"change": 18,
"day": "2026-09-19",
"days_spanned": 1,
"subjects_counted": 3,
"value": 12430
}
],
"source": "reported"
}
],
"to": "2026-09-19"
}
}{
"error": {
"code": "resource.not_found",
"message": "Account not found",
"meta": {}
}
}{
"error": {
"code": "resource.not_found",
"message": "Account not found",
"meta": {}
}
}{
"error": {
"code": "resource.not_found",
"message": "Account not found",
"meta": {}
}
}Analytics
Get brand analytics history
Returns daily history for every account and page in a brand, summed per metric per day. A brand total always reflects the accounts the brand holds right now. Read subjects_counted before drawing a chart. A brand whose accounts did not all report on a given day produces a lower sum for that day, and without the count that reads as a decline instead of a gap.
GET
/
brands
/
{id}
/
analytics
Get brand analytics history
curl --request GET \
--url https://api.social-api.ai/v1/brands/{id}/analytics \
--header 'Authorization: <api-key>'const options = {method: 'GET', headers: {Authorization: '<api-key>'}};
fetch('https://api.social-api.ai/v1/brands/{id}/analytics', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.social-api.ai/v1/brands/{id}/analytics"
headers = {"Authorization": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": {
"from": "2026-08-21",
"series": [
{
"day_tz": "America/Los_Angeles",
"kind": "gauge",
"metric": "page_follows",
"points": [
{
"change": 18,
"day": "2026-09-19",
"days_spanned": 1,
"subjects_counted": 3,
"value": 12430
}
],
"source": "reported"
}
],
"to": "2026-09-19"
}
}{
"error": {
"code": "resource.not_found",
"message": "Account not found",
"meta": {}
}
}{
"error": {
"code": "resource.not_found",
"message": "Account not found",
"meta": {}
}
}{
"error": {
"code": "resource.not_found",
"message": "Account not found",
"meta": {}
}
}Authorizations
Prefix your API key with "Bearer ". Example: Authorization: Bearer sapi_key_...
Path Parameters
Brand ID
Query Parameters
First day, YYYY-MM-DD. Defaults to 29 days before to.
Last day, YYYY-MM-DD. Defaults to today (UTC).
Comma-separated metric names. Defaults to every stored metric.
Response
OK
Show child attributes
Show child attributes