TikTok Ad Details

{
  "type": "object",
  "required": [
    "ads_id"
  ],
  "properties": {
    "ads_id": {
      "type": "string",
      "description": "The ad's numeric id in the TikTok ad library, as a string of digits."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "msg": {
      "type": "string"
    },
    "code": {
      "type": "number"
    },
    "data": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "The ad's id."
        },
        "ctr": {
          "type": "number",
          "description": "The click-through rate figure the ad library reports for the ad."
        },
        "cost": {
          "type": "number",
          "description": "The ad library's cost score for the ad, a small integer tier."
        },
        "like": {
          "type": "number",
          "description": "The ad's like count."
        },
        "share": {
          "type": "number",
          "description": "The ad's share count."
        },
        "comment": {
          "type": "number",
          "description": "The ad's comment count."
        },
        "ad_title": {
          "type": "string",
          "description": "The ad's title or caption text, as the advertiser wrote it."
        },
        "brand_name": {
          "type": "string",
          "description": "The advertiser's brand name; empty when the library has none."
        },
        "video_info": {
          "type": "object",
          "properties": {
            "width": {
              "type": "number",
              "description": "The video's width in pixels."
            },
            "height": {
              "type": "number",
              "description": "The video's height in pixels."
            },
            "duration": {
              "type": "number",
              "description": "The ad video's length in seconds."
            }
          }
        },
        "country_code": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Two-letter codes of the countries the ad ran in."
        },
        "industry_key": {
          "type": "string",
          "description": "The ad library's industry label code for the ad."
        },
        "objective_key": {
          "type": "string",
          "description": "The campaign objective label, such as a conversion or sales objective."
        }
      }
    }
  },
  "description": "One ad from the ad library, as returned after shaping."
}