TikTok Creative Center Top Ads
TikTok 创意中心的 Top Ads 是一批经过筛选、表现突出的广告,每条都带有文案、行业、投放目标、点击率、点赞数和视频本身。把它们放在一起看,就能发现某个品类里哪些开头、形式和卖点一直有效,因此常被用来做素材研究、盯竞品和写广告 brief。
TikTok Creative Center Top Ads API 主要特性
- 创意中心自己的高效广告榜结果来自创意中心认定的高效广告,可按 TikTok 的相关度或点赞数排序。
- 每条广告的点击率、点赞和投放背景每条广告带有 ctr 和点赞数,以及创意中心标注的 industry 行业和 objective 投放目标。
- 不只有数字,还有广告视频media 返回广告视频地址及封面、宽高和时长,文案在 text 里。
- 关键词、时间窗和数量可控query 按关键词收窄,time_range 回看 7、30 或 180 天,results_limit 一次最多返回 300 条广告。
TikTok Creative Center Top Ads API 参数
| 参数 | 必填 | 描述 |
|---|---|---|
query | 可选 | 可选,用于筛选广告的关键词,例如产品品类。 |
time_range | 可选 | 回看多长时间:7d、30d(默认)或 180d。 |
sort_by | 可选 | relevance 按 TikTok 自己的顺序(默认),likes 让点赞最多的广告排在前面。 |
results_limit | 可选 | 返回的广告数量,取值 1 到 300,默认 20。 |
如何使用 TikTok Creative Center Top Ads API
设置筛选条件,分页读取高效广告。
- 向 /v1/tiktok-creative-center/top-ads 发送 {"query": "skincare", "time_range": "30d", "sort_by": "likes"}。
- 轮询 GET /v1/tasks/{task_id},直到 status 变成 succeeded。
- 从 results.items 读取广告;has_more 为 true 时,带上 results.next_cursor 继续读取。
curl -X POST "https://api.socq.ai/v1/tiktok-creative-center/top-ads" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"skincare","time_range":"30d","sort_by":"likes"}'
# 每条结果的 id 可以交给 TikTok Creative Center Ad Analysis。TikTok Creative Center Top Ads API 最佳使用场景
- 给一个产品品类建素材库: 用产品关键词查询,把排在前面的广告的文案、视频和 duration_seconds 存下来,作为设计师和剪辑师的参考集。
- 区分新出现的开头和长期有效的开头: 同一个关键词分别用 7d 和 180d 各跑一次:两个时间窗里都出现的广告是持续有效的形式,只在短时间窗里出现的则是当下的新尝试。
- 在同一投放目标内按点击率挑广告: 一次拉取较大的批量,按 objective 分组,再在每组内按 ctr 排序,挑出值得细看的广告。
- 批量给开头和形式打标签: 把文案、视频文件和时长喂给自己的打标流程,统计某个品类里哪些开头类型和视频长度占多数。
TikTok Creative Center Top Ads API 使用建议
- ctr 只在同一批结果、同一投放目标内互相比较:它的单位文档里没有说明,结果里也没有预算和优惠信息,所以让广告彼此排名,不要拿它去对照 TikTok 的通用点击率基准。
- sort_by 只有 relevance 和 likes 两种,想按点击率排序,就把 results_limit 开大一些,在自己的代码里按 ctr 排。
- 读字段要留余地:industry 和 objective 返回的是创意中心的标签代码,例如 campaign_objective_video_view;文档示例里 advertiser 以及 metrics 中的评论、分享、播放数都是 null。
- 每次运行都保存广告的 id 并按它去重,同一条广告可能在不同关键词和时间窗下重复出现。
- 只把筛出来的候选 id 交给 TikTok Creative Center Ad Analysis,每条 1 积分,能补上投放国家和逐秒曲线。
相关 API
除了 TikTok Creative Center Top Ads API,需要其他类型的 TikTok Creative Center 公开数据时,可以使用以下 API。
- TikTok Creative Center Ad Analysis API — 按秒拆解一条热门广告的点击曲线和留存曲线。
- TikTok Creative Center Trending Hashtags API — 获取某个国家或地区的趋势话题榜,包含发帖数、播放量和热度曲线。
- TikTok Creative Center Hashtag Insights API — 深入查看单个趋势话题的热度曲线、热门地区和示例视频。
- TikTok Creative Center Top Videos API — 获取某个国家或地区的热门视频榜,包含播放量和互动率。
- TikTok Creator Marketplace API — 获取创作者市场资料卡,包含粉丝画像、播放中位数和起步报价。