[中文]

用途:

获取TikTok单个广告的详细信息，包括广告素材、创作者信息、互动数据等

分析广告的表现指标，如观看量、点赞数、评论数等核心数据

帮助广告主和营销人员深入了解特定广告的效果和用户反馈

参数:

ads_id: 广告ID，必填参数，可从广告列表或TikTok Ads Creative Center获取

返回内容说明:

ad_title: 广告标题

brand_name: 品牌名称

comment: 评论数

cost: 花费等级(1-5)

country_code: 投放国家代码列表

ctr: 点击率（百分比）

favorite: 是否收藏

has_summary: 是否有摘要

highlight_text: 高亮文本

id: 广告ID

industry_key: 行业标签

is_search: 是否搜索结果

keyword_list: 关键词列表

landing_page: 落地页URL

like: 点赞数

objective_key: 广告目标键

objectives: 广告目标列表

label: 目标标签

value: 目标值

pattern_label: 模式标签列表

share: 分享数

source: 来源

source_key: 来源键值

tag: 标签

video_info: 视频信息

vid: 视频ID

duration: 时长（秒）

cover: 封面图URL

video_url: 视频播放地址

720p: 720p质量视频URL

width: 视频宽度

height: 视频高度

voice_over: 是否有配音

示例响应:

{
  "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
    }
  }
}

[English]

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
    }
  }
}

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Responses

🟢200OK

application/json

Successful Response

Body

code

integer

Code

optional

HTTP status code | HTTP状态码

Default:

200

router

string

Router

optional

The endpoint that generated this response | 生成此响应的端点

Default:

params

Params

optional

The parameters used in the request | 请求中使用的参数

Default:

{}

data

Data

optional

The response data | 响应数据

Any of

null

Example

{
    "code": 200,
    "router": "",
    "params": {},
    "data": null
}

🟠422Parameter Error

获取单个广告详情/Get single ad detail

[中文]

用途:

参数:

返回内容说明:

示例响应:

[English]

Purpose:

Parameters:

Return Description:

Example Response:

Request

Request samples

Responses

获取单个广告详情/Get single ad detail

[中文]#

用途:#

参数:#

返回内容说明:#

示例响应:#

[English]#

Purpose:#

Parameters:#

Return Description:#

Example Response:#

Request

Request samples

Responses

[中文]

用途:

参数:

返回内容说明:

示例响应:

[English]

Purpose:

Parameters:

Return Description:

Example Response: