tiktok/ads/ads-detail

Get single ad detail

Purpose:

• Retrieve detailed information about a single TikTok ad, including creative content, creator info, and engagement data
• Analyze ad performance metrics such as views, likes, comments, and other core statistics
• Help advertisers and marketers gain deep insights into specific ad effectiveness and user feedback

Parameters:

• ads_id: Ad ID, required parameter, can be obtained from ad lists or TikTok Ads Creative Center

Return Description:

• ad_title: Ad title
• brand_name: Brand name
• comment: Comment count
• cost: Cost level (1-5)
• country_code: List of target country codes
• ctr: Click-through rate (percentage)
• favorite: Whether favorited
• has_summary: Whether has summary
• highlight_text: Highlight text
• id: Ad ID
• industry_key: Industry label
• is_search: Whether from search results
• keyword_list: List of keywords
• landing_page: Landing page URL
• like: Like count
• objective_key: Ad objective key
• objectives: List of ad objectives
  • label: Objective label
  • value: Objective value
• pattern_label: List of pattern labels
• share: Share count
• source: Source
• source_key: Source key value
• tag: Tag
• video_info: Video information
  • vid: Video ID
  • duration: Duration (seconds)
  • cover: Cover image URL
  • video_url: Video playback URLs
    • 720p: 720p quality video URL
  • width: Video width
  • height: Video height
• voice_over: Whether has voice over

Example Response:

{
  "code": 200,
  "router": "/api/v1/tiktok/ads/get_ads_detail",
  "params": {
    "ads_id": "7131673574381518849"
  },
  "data": {
    "code": 0,
    "msg": "OK",
    "data": {
      "ad_title": "BLACK FRIDAY SALE at 50% OFF + FREE SHIPPING",
      "brand_name": "The Bamboo Breeze Shop",
      "comment": 232,
      "cost": 2,
      "country_code": ["US", "CA", "PH", "SE", "FI"],
      "ctr": 0.14,
      "favorite": false,
      "has_summary": true,
      "highlight_text": "",
      "id": "7131673574381518849",
      "industry_key": "label_29100000000",
      "is_search": false,
      "keyword_list": [
        "adjustable back posture corrector",
        "poor posture",
        "eliminate unnecessary back pain"
      ],
      "landing_page": "https://thebamboobreezeshop.com/products/adjustable-back-shoulder-posture-corrector",
      "like": 61242,
      "objective_key": "campaign_objective_conversion",
      "objectives": [
        {
          "label": "campaign_objective_conversion",
          "value": 3
        },
        {
          "label": "campaign_objective_product_sales",
          "value": 15
        }
      ],
      "pattern_label": [],
      "share": 6486,
      "source": "TikTok Ads Manager",
      "source_key": 1,
      "tag": 3,
      "video_info": {
        "vid": "v12025gd0000cuavia7og65o5g7ucnb0",
        "duration": 17,
        "cover": "https://p16-sign-va.tiktokcdn.com/xxx",
        "video_url": {
          "720p": "https://v16m-default.tiktokcdn.com/xxx"
        },
        "width": 576,
        "height": 1024
      },
      "voice_over": true
    }
  }
}

Imported from a validated TikHub OpenAPI document. Pricing must be reviewed before enabling.