营销人员在 TikTok 创意中心查看表现最好的广告、某个国家正在上升的话题标签和登上榜单的视频。创作者市场则提供达人的受众数据和起步报价。2026-11-17,SocQ 新增了 6 个以 JSON 返回这些数据的接口,列在 TikTok 创意中心平台页。
这 6 个接口分成三对:列表接口找出候选,详情接口拿列表里的 ID 返回深度数据。本文逐对说明:返回什么、请求怎么写、价格多少、何时使用。
快速回答: 向
POST https://api.socq.ai/v1/tiktok-creative-center/<endpoint>发送 JSON 请求体。保存返回的task_id,轮询GET /v1/tasks/{task_id}直到status为succeeded,再读取data.results.items。
新的 TikTok 创意中心接口
1 SocQ credit = $0.005。列表接口按结果计费,没有基础费用。
| 接口 | 返回内容 | 价格 |
|---|---|---|
| 热门广告 API | 表现最好的广告,含文案、广告主、行业、投放目标、CTR、点赞和视频 | 每条广告 0.5 credits($0.0025) |
| 广告分析 API | 单条广告的详情、曝光百分位,以及逐秒的点击率和留存曲线 | 每次调用 1 credit($0.005) |
| 热门话题 API | 某国热门话题标签,含排名、帖子数、播放量和每日热度曲线 | 每个话题 0.5 credits($0.0025) |
| 话题洞察 API | 单个话题的总量、热度曲线、热门国家和示例视频 ID | 每次调用 0.5 credits($0.0025) |
| 热门视频榜 API | 某国热门视频榜,含排名、创作者、榜单期与累计播放量和互动率 | 每条视频 0.5 credits($0.0025) |
| 创作者市场 API | 创作者卡片,含粉丝年龄、性别、国家和设备分布、播放中位数、互动率和起步报价 | 每位创作者 0.5 credits($0.0025) |
认证与异步任务流程
所有请求都用 API key 认证。提交、查询任务状态和读取结果使用同一个请求头:
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
每次采集都作为后台任务运行:
submit -> task_id -> queued -> running -> succeeded
\-> failed
提交请求会立即返回 data.task_id 和 data.status。用这个 ID 轮询任务:
curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
-H "Authorization: Bearer $SOCQ_API_KEY"
当 status 为 succeeded 时,响应包含 result_count、credits_amount,以及 data.results.items 中第一页标准化记录。limit 默认 50,最大 500。如果 results.has_more 为 true,把 results.next_cursor 作为 cursor 传入即可读取下一页。失败的任务带有 error_message。
这里每个接口都接受可选的 callback_url。任务结束后,SocQ 会发送一次带任务摘要的 POST;记录仍从任务接口读取。客户端超时不会取消任务,请用同一个任务 ID 继续读取,不要重新提交。402 表示账户余额不足,429 表示 key 触发了频率或额度限制。
热门广告与广告分析:建立广告素材库
热门广告 API 浏览 TikTok 创意中心评为表现最好的广告。每条广告含文案、广告主、行业、投放目标、ctr、点赞和完整视频。所有字段都是可选的:query 匹配广告文案和品牌,time_range 可选 7d、30d(默认)或 180d,sort_by 可选 relevance(默认)或 likes。results_limit 默认 20,取值 1 到 300。(文档)
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"}'
广告分析 API 把一条热门广告结果的 id 作为 ad_id。除了广告详情、投放国家和落地页,它还返回与同类广告相比的 impressions_percentile,以及 click_through_curve 和 retention_curve,两者都是视频每一秒的数值。把两条曲线放在一起看,可以找到开头的钩子、观众流失的位置和他们行动的时刻。(文档)
curl -X POST "https://api.socq.ai/v1/tiktok-creative-center/ad-analysis" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"ad_id": "7697084527089729557"}'
适用场景: 为新投放做创意研究。拉取你所在类目的 20 条热门广告(10 credits),再分析最相关的 5 条(5 credits),合计 15 credits,即 $0.075。
热门话题与话题洞察:按国家发现上升的标签
热门话题 API 返回某个国家正在上升的话题标签,每个含排名、帖子数、播放量和统计期内的每日 popularity_curve。所有字段都是可选的:country 为两位国家代码(默认 US),time_range 可选 7d(默认)、30d 或 90d。results_limit 默认 20,取值 1 到 100。(文档)
curl -X POST "https://api.socq.ai/v1/tiktok-creative-center/trending-hashtags" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"country": "US", "time_range": "7d", "results_limit": 20}'
话题洞察 API 把热门话题结果的 id 作为 hashtag_id,并使用相同的 country。它返回帖子和播放总量、每日热度曲线、top_countries(每个国家一个分数,表示相对该国规模的热门程度),以及示例视频的 video_ids。time_range 默认 7d。(文档)
curl -X POST "https://api.socq.ai/v1/tiktok-creative-center/trending-hashtag-detail" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"hashtag_id": "7155204034885287979", "country": "US", "time_range": "7d"}'
适用场景: 在特定市场上线时挑选话题标签,或在围绕某个标签做内容前确认它是全球热门还是本地热门。如果只想衡量已有的标签,包括没上热门的,TikTok 话题播放量 API 一次可返回最多 20 个标签的视频总数和播放总量。
热门视频榜与创作者市场:找到达人和报价
热门视频榜 API 读取 TikTok 创意中心某个国家的热门视频榜。每条含排名、文案、创作者、creator_id、榜单期播放量、自然播放量、累计播放量、互动率和 6 秒观看率。所有字段都是可选的:country 默认 US,period 可选 daily(默认)、weekly 或 long_term,sort_by 可选 views(默认)、engagement_rate 或 six_second_view_rate。使用最新发布的榜单。results_limit 默认 20,取值 1 到 100。(文档)
curl -X POST "https://api.socq.ai/v1/tiktok-creative-center/top-videos" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"country": "US", "period": "daily", "results_limit": 20}'
创作者市场 API 接收 1 到 20 个数字 creator_ids,例如热门视频榜中的 creator_id。每位有卡片的创作者返回粉丝的年龄、性别、国家和设备分布,以及粉丝数、播放中位数、互动率、粉丝增长率、6 秒观看率、最近视频 ID,和他们为一条商单视频标出的 starting_price。只有有卡片的创作者计费。(文档)
curl -X POST "https://api.socq.ai/v1/tiktok-creative-center/creator-cards" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"creator_ids": ["7011198409688219653", "7070293872819044358"]}'
适用场景: 带着预算建立达人候选名单。20 条视频的日榜(10 credits)加 20 位创作者的卡片(10 credits),共 20 credits,即 $0.10。
与其他 TikTok 接口的配合
创意中心的数据由 TikTok 汇总:榜单、排名和曲线。达人自己的主页、视频和评论,请使用 TikTok 采集指南 中的接口。达人公开账号的粉丝国家分布和刷量检测,见 TikTok 新接口指南。在 Meta 上投放的广告,见 Facebook 广告库 API。
常见问题
需要 TikTok 广告账户或创作者市场账户吗?
不需要。你用 SocQ API key 认证,并发送上文所示的字段。
ad_id 从哪里来?
来自热门广告结果:把它的 id 作为 ad_id 传给广告分析。同理,热门话题的 id 作为 hashtag_id 传给话题洞察,热门视频榜的 creator_id 传给创作者市场。
可以查询哪些国家?
热门话题、话题洞察和热门视频榜接受两位国家代码 country,例如 US、GB 或 JP,默认 US。话题洞察请使用找到该话题时的同一个 country。
创作者的起步报价一定有吗?
报价是创作者市场卡片的一部分,只有有卡片的创作者才返回结果。和 SocQ 的其他字段一样,来源没有提供的值返回 null。
空结果如何计费?
按结果计费的接口没有基础费用,什么都没返回的调用不收费。广告分析和话题洞察每次调用计费一次。
TIKTOK CREATIVE CENTER API
使用公开的 TikTok Creative Center 输入测试工作流
提交公开输入,获取带有可追溯来源上下文的标准化记录。
查看 TikTok Creative Center API