跳转到主要内容
POST
TikTok 话题播放量

TikTok 话题播放量

衡量一个话题在 TikTok 上有多大:用过这个话题的视频总数,以及这些视频的累计播放量。一次请求最多放 20 个话题,挑活动标签之前可以把候选话题摆在一起比一比。
hashtags 为必填项,传 1–20 个话题名称,可带或不带 #。每个存在的话题返回一条结果并按条计费;不存在的话题会被跳过。

标准结果字段

任务结果使用下方稳定的 SocQ 字段。系统会统一来源特有的字段名和格式,但不会推断或补充来源未提供的数据。如需缩小返回字段集合,MCP 查询使用 fields,Typed 工具使用 _result_fields,CLI 使用 --result-fields。声明字段的值为 null 时仍会保留。 以下示例展示任务完成后的响应格式,具体数据以实际查询结果为准。

任务完成响应

授权

Authorization
string
header
必填

使用 Authorization: Bearer <token> 请求头进行身份验证。

请求体

application/json

hashtags 为必填项,传 1–20 个话题名称,可带或不带 #。每个存在的话题返回一条结果并按条计费;不存在的话题会被跳过。

hashtags
string[]
必填

话题名称,可带或不带 # 前缀,每次请求最多 20 个,至少提供 1 项,最多提供 20 项。

Required array length: 1 - 20 elements
Minimum string length: 1
callback_url
string<uri>

可选的任务完成回调 URL。

响应

任务已受理

code
integer

HTTP 业务状态码。

data
object