WellbyteWellbyte

POST /v1/tiktok/ads/get_query_suggestions

获取查询建议

stable · 2 credits / 次(成功才计)

获取广告搜索的热门查询建议;了解当前流行的广告搜索关键词和趋势;帮助发现新的广告创意方向和热点话题;query: 场景1留空返回热门建议;场景2传入关键词返回联想建议;count: 返回的建议数量,默认50;scenario: 场景类型,1为热门建议,2为关键词联想;country_code: 国家/地区代码,可选;cookie: 自定义Cookie字符串,可选参数,可以使用自己的Cookie来获取更多数据;注意;如果您应用了一个或多个筛选条件后没有返回任何结果,请尝试调整或移除部分筛选条件。TikTok 创作者数据集仅收录部分热门数据,不一定包含全量数据。;返回内容说明;`query`: 查询建议列表(字符串数组);示例响应;```json;{;"code": 200,;"router": "/api/v1/tiktok/ads/get_query_suggestions",;"par…

注册即送 500 credits,用自己的 Key 试调。 免费注册

请求

curl -s -X POST 'https://api.wellbyte.net/v1/tiktok/ads/get_query_suggestions' \
  -H "Authorization: Bearer dg_live_…" \
  -H "Content-Type: application/json" \
  -d '{"count":20,"query":"demo","cookie":"demo","scenario":null,"country_code":"demo"}'

响应

示例采集于 2026-08-25

data{
code:0
data{
query[ 0 items ]
}
meta{
endpoint:"tiktok.ads.get_query_suggestions"
cache_hit:false
elapsed_ms:0
request_id:"req_sample"
credits_charged:0
}
message:"ok"
}

请求历史

打开完整日志

还没有调用记录。先跑通一次,再换成你的数据。

    请求参数

    参数类型位置必填说明示例
    countintegerbody建议数量20
    querystringbody场景1留空返回热门建议;场景2传入关键词demo
    cookiestringbody自定义Cookie字符串(可选)demo
    scenariointegerbody场景类型:1热门建议,2关键词联想demo
    country_codestringbody可选国家demo

    响应字段

    字段字典待补 —— 右侧可执行区可直接看到真实结构。

    错误码

    codeHTTP含义是否计费
    40001400参数缺失或格式错误
    40102401API Key 无效或已吊销
    40201402余额不足,请充值
    40402404目标资源不存在
    42201422质量门槛未通过
    42901429超出速率限制
    50401504上游超时
    50201502上游返回异常

    计费

    成功扣 2 credits;任何失败(含上游 200 但未过质量门槛)扣 0。

    搜索

    搜索端点与文档