跳转到主要内容
POST
TikTok 创作者搜索洞察

TikTok 创作者搜索洞察

看看大家在 TikTok 上搜什么、热度往哪个方向走。每个搜索词都有 0–100 的热度分、7 个点的走势和相关视频数。把 filter_by 设成 content_gap,能找出搜得多但视频还少的词,做内容规划时很适合从这里下手。
所有字段都可省略。language(默认 en)、category 和 filter_by(all 或 content_gap)决定返回哪些搜索词。每次请求返回 20 个搜索词,按次计费。

标准结果字段

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

任务完成响应

授权

Authorization
string
header
必填

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

请求体

application/json

所有字段都可省略。language(默认 en)、category 和 filter_by(all 或 content_gap)决定返回哪些搜索词。每次请求返回 20 个搜索词,按次计费。

callback_url
string<uri>

可选的任务完成回调 URL。

category
enum<string>

只返回某一内容分类下的搜索词。

可用选项:
fashion,
food,
gaming,
science,
sports,
tourism
Minimum string length: 1
filter_by
enum<string>
默认值:all

all 返回热门搜索词,content_gap 返回视频还不多的搜索词。

可用选项:
all,
content_gap
Minimum string length: 1
language
enum<string>
默认值:en

返回的搜索词所使用的语言。

可用选项:
ar,
de,
en,
es,
fr,
id,
ja,
ko,
pt,
th,
tr,
vi
Minimum string length: 1

响应

任务已受理

code
integer

HTTP 业务状态码。

data
object