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