List a brand's tracked ads
**Deprecated** — use List a brand's ads (v2) (POST /following/v2/brand/ads), which adds advanced filters, more sorts, per-ad insights, and cursor pagination. This v1 endpoint keeps working unchanged. Returns the ads tracked for a brand, with filtering, sorting, and skip/limit (offset) pagination.
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
application/json
curl -X POST "https://api.adnova.ai/following/v1/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" ] }, "sortBy": "newest", "skip": 0, "limit": 25 }'{
"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"
}
]
}
],
"metadata": {
"skip": 0,
"limit": 25
}
}{
"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"
}
}