Get a brand analysis
Returns a single per-brand Following Brands analysis selected by dataType, windowed by datePreset. Always HTTP 200 with status ok (analysis fields returned at the top level) or pending (retry later). The data shape depends on dataType — see Analysis Types for what each type returns, plus a worked response per type in the 200 examples below.
Authentication
authentication Create an API key from the Adnova dashboard (Account integrations). Pass the key value in the api-key request header on every call.
In: header
Header Parameters
Organization ULID that scopes the request.
Workspace ULID that scopes the request.
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://api.adnova.ai/following/v1/brand/analysis" \ -H "x-org-id: 01K8Z23F1QQ1ZA93B8WYBS40GH" \ -H "x-workspace-id: 01KJ7S42FHQTCTKD6KKFJKTZBC" \ -H "Content-Type: application/json" \ -d '{ "brandId": "01HDRYKE8F11GG6S1HWGWG5YMG", "dataType": "ad_angle_diversity", "datePreset": "last_30d" }'{
"status": "ok",
"brandId": "01HDRYKE8F11GG6S1HWGWG5YMG",
"dataType": "overview",
"datePreset": "last_30d",
"modifiedAt": "2026-04-18T15:18:15.678Z",
"data": {
"totalCreatives": 8624,
"avgRunningDays": 47.3,
"totalRunningDays": 408000,
"mediaMix": {
"image": {
"active": 1200,
"inactive": 2433,
"total": 3633
},
"video": {
"active": 870,
"inactive": 4121,
"total": 4991
},
"carousel": {
"active": 0,
"inactive": 0,
"total": 0
}
}
}
}{
"error": {
"code": "string",
"message": "string"
}
}{
"error": {
"code": "string",
"message": "string"
}
}{
"error": {
"code": "string",
"message": "string"
}
}{
"error": {
"code": "RATE_LIMIT_EXCEEDED",
"message": "Too many requests."
}
}{
"error": {
"code": "string",
"message": "string"
}
}