AdnovaDocs
Analytics

List AI tags

Returns the AI-generated tag taxonomy for this ad account — Adnova labels each creative with attributes like offer, persona, visual_hook. Each attribute has a list of values that appear in the account. Use the tag value ids when filtering Fetch ad insights with field: aiTags (set aiTagAttribute to the attribute name and pass tag ids in value).

GET
/ai_tags

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

Query Parameters

platform*string

Ad platform the account lives on. Must match the platform field on the ad account row from List ad accounts.

Value in"facebook" | "tiktok"
adAccountId*string

AdAccountId required to map the platform account. Read id from the List Ad Accounts response. Pass it as adAccountId to Analytics endpoints.

Length1 <= length

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.adnova.ai/analytics/v1/ai_tags?platform=facebook&adAccountId=string"
{
  "platform": "facebook",
  "adAccountId": "string",
  "aiTagAttributes": {
    "property1": [
      {
        "id": "string",
        "label": "string"
      }
    ],
    "property2": [
      {
        "id": "string",
        "label": "string"
      }
    ]
  }
}
{
  "error": {
    "code": "string",
    "message": "string"
  },
  "message": "string"
}
{
  "error": {
    "code": "string",
    "message": "string"
  },
  "message": "string"
}
{
  "error": {
    "code": "string",
    "message": "string"
  },
  "message": "string"
}
{
  "error": {
    "code": "string",
    "message": "string"
  },
  "message": "string"
}
{
  "error": {
    "code": "string",
    "message": "string"
  },
  "message": "string"
}