AdnovaDocs
Following Brands

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.

POST
/brand/analysis

Authentication

authentication
api-key<token>

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

x-org-id*string

Organization ULID that scopes the request.

x-workspace-id*string

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"
  }
}