AdnovaDocs
Following Brands

List a brand's tracked ads — v2

Returns the ads tracked for a brand, with filtering, free-text query, sorting, and cursor pagination. Pass the previous response's metadata.nextCursor back as nextCursor to fetch the next page; null means there are no more pages. The cursor is opaque — treat it as a token and do not construct it by hand.

POST
/brand/ads

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

application/json

curl -X POST "https://api.adnova.ai/following/v2/brand/ads" \  -H "x-org-id: 01K8Z23F1QQ1ZA93B8WYBS40GH" \  -H "x-workspace-id: 01KJ7S42FHQTCTKD6KKFJKTZBC" \  -H "Content-Type: application/json" \  -d '{    "filter": {      "brandId": "01HDRYKE8F11GG6S1HWGWG5YMG",      "datePreset": "last_30d",      "isActive": true,      "format": [        "image",        "video"      ],      "scaled": "high",      "spendRange": {        "start": 1000,        "end": 100000      }    },    "sortBy": "newest",    "nextCursor": null  }'
{
  "data": [
    {
      "inspirationAdId": "01KSKP38BAG8REP57BKKZPSP8W",
      "isActive": true,
      "format": "IMAGE",
      "brandId": "string",
      "landingPageUrl": "string",
      "publisherPlatforms": [
        "facebook",
        "instagram"
      ],
      "likes": 0,
      "startDate": 0,
      "endDate": 0,
      "runningDays": 0,
      "advertiser": {
        "name": "string",
        "logoUrl": "string"
      },
      "creatives": [
        {
          "type": "image",
          "mediaUrl": "string",
          "thumbnailUrl": "string",
          "headline": "string",
          "body": "string",
          "caption": "string",
          "ctaText": "string",
          "ctaType": "string",
          "linkUrl": "string"
        }
      ],
      "insights": {
        "countries": [
          "US",
          "GB"
        ],
        "regions": [
          "EU"
        ],
        "similarAdCount": 7,
        "fbAdRank": 12,
        "reach": 400000,
        "estimatedSpend": 15000
      }
    }
  ],
  "metadata": {
    "nextCursor": "string"
  }
}
{
  "error": {
    "code": "string",
    "message": "string"
  }
}
{
  "error": {
    "code": "string",
    "message": "string"
  }
}
{
  "error": {
    "code": "API_CREDITS_EXHAUSTED",
    "message": "API credits exhausted for the current period",
    "details": {
      "creditsUsed": 10,
      "creditsLimit": 10,
      "creditsRemaining": 0,
      "period": {
        "start": "2026-05-18T00:00:00.000Z",
        "end": "2026-06-18T00:00:00.000Z"
      }
    }
  }
}
{
  "error": {
    "code": "string",
    "message": "string"
  }
}
{
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Too many requests."
  }
}
{
  "error": {
    "code": "string",
    "message": "string"
  }
}