--- title: "获取单个广告详情/Get single ad detail" method: POST path: "/api/v1/tiktok/ads/get_ads_detail" tags: ["TikTok-Ads-API"] --- # 获取单个广告详情/Get single ad detail `POST /api/v1/tiktok/ads/get_ads_detail` ## Request - Base URL: `https://api.tikhub.io` (the document declares no server; this is the origin it was published from) - URL: `https://api.tikhub.io/api/v1/tiktok/ads/get_ads_detail` - Auth: HTTP bearer # [中文] ### 用途: - 获取TikTok单个广告的详细信息，包括广告素材、创作者信息、互动数据等 - 分析广告的表现指标，如观看量、点赞数、评论数等核心数据 - 帮助广告主和营销人员深入了解特定广告的效果和用户反馈 ### 参数: - ads_id: 广告ID，必填参数，可从广告列表或TikTok Ads Creative Center获取 - cookie: 自定义Cookie字符串，可选参数，可以使用自己的Cookie来获取更多数据 ### 返回内容说明: - `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`: 是否有配音 ### 示例响应: ```json { "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 - cookie: Custom Cookie string, optional parameter, can be used to fetch more data ### 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: ```json { "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 } } } ``` ## Request body - BodyGetAdsDetailApiV1TiktokAdsGetAdsDetailPost - `ads_id` string, required: 广告ID/Ad ID - `cookie` string: 自定义Cookie字符串（可选） ## Response `200` Successful Response - ResponseModel - `code` integer: HTTP status code | HTTP状态码 - `request_id` string, nullable: Unique request identifier | 唯一请求标识符 - `message` string: Response message (EN-US) | 响应消息 (English) - `message_zh` string: Response message (ZH-CN) | 响应消息 (中文) - `support` string: Support message | 支持消息 - `time` string: The time the response was generated | 生成响应的时间 - `time_stamp` integer: The timestamp the response was generated | 生成响应的时间戳 - `time_zone` string: The timezone of the response time | 响应时间的时区 - `docs` string, nullable: Link to the API Swagger documentation for this endpoint | 此端点的 API Swagger 文档链接 - `cache_message` string, nullable: Cache message (EN-US) | 缓存消息 (English) - `cache_message_zh` string, nullable: Cache message (ZH-CN) | 缓存消息 (中文) - `cache_url` string, nullable: The URL to access the cached result | 访问缓存结果的 URL - `router` string: The endpoint that generated this response | 生成此响应的端点 - `params` unknown - `data` unknown ## Other responses - `422`: Validation Error ## Changes - **2026-10-08** `96a122a5f220`: 2 info - added the optional property `detail/items/ctx` to the response with the `422` status - added the optional property `detail/items/input` to the response with the `422` status - **2026-09-01** `50f9ec6e1cd3`: 1 info - endpoint added [Operation history](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi/changes/api/v1/tiktok/ads/get_ads_detail/post.md) --- [API](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi.md) - [All operations](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi/llms.txt) - [OpenAPI document](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi/revisions/86a3483c705a?raw)