tiktok-creative-center/
top-ads

按关键词、7/30/180 天时间窗和排序方式获取 TikTok 创意中心的高效广告,返回广告文案、点击率、点赞、投放目标、行业和广告视频。

TikTok Creative Center Top Ads API

高效广告
每条广告的点击率
广告视频文件
每条结果 0.5 积分
等待提交
等待提交

填写参数并发送请求,任务状态和标准化结果会显示在这里。

README

由 SocQ 维护 · 更新于

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

设置筛选条件,分页读取高效广告。

  1. 向 /v1/tiktok-creative-center/top-ads 发送 {"query": "skincare", "time_range": "30d", "sort_by": "likes"}。
  2. 轮询 GET /v1/tasks/{task_id},直到 status 变成 succeeded。
  3. 从 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 积分,能补上投放国家和逐秒曲线。

除了 TikTok Creative Center Top Ads API,需要其他类型的 TikTok Creative Center 公开数据时,可以使用以下 API。

探索其他平台

还可以将 TikTok Creative Center 数据与其他已支持社交平台的公开数据结合使用。

TikTok Creative Center Top Ads API — 常见问题

TikTok Creative Center Top Ads API 是一个用于按关键词、时间窗和排序方式获取 TikTok 创意中心高效广告的 API。它返回每条广告的文案、行业、投放目标、点击率、点赞数和视频。

不是。Top Ads 是精选出来的高表现广告,带点击率和点赞数;TikTok Ad Library 是已投放广告的透明度档案,按广告主或关键词查,不提供点击率。

不能。Top Ads 只收录广告主授权创意中心展示的广告,是高表现样本,不是完整记录。要按广告主查,请用 TikTok Ad Library 的相关接口。

这个接口不行,它只按关键词和 time_range 筛选。行业和投放目标会随每条广告返回,请求之后自己过滤即可;广告的投放国家要到 TikTok Creative Center Ad Analysis 里读。

sort_by 只支持 relevance 和 likes。请求最多 300 条,再按返回的 ctr 自己排序。

每返回一条广告 0.5 积分,300 条就是 150 积分。请求没有返回任何广告时不扣费。

每条广告的 media 里有视频地址、封面、尺寸和时长,可以直接取文件。视频版权属于广告主,请只用于研究和参考,不要二次发布。