跳转到主要内容
POST
TikTok Shop 热卖商品

TikTok Shop 热卖商品

看看某个市场的 TikTok Shop 上什么在卖。商品按 TikTok Shop 的排序返回,每件包含标题、售价和币种、销量、评分、评论数、店铺和商品图片。按市场每周跑一次,就能发现爆款苗头、对比价格带,或者挑出值得选品和推广的商品。
通过 region 指定市场:ID、JP、MX、MY、PH、SG、TH 或 VN。results_limit 默认 50,可填 1–200 之间的整数。每件商品计 0.5 积分。

标准结果字段

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

任务完成响应

授权

Authorization
string
header
必填

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

请求体

application/json

通过 region 指定市场:ID、JP、MX、MY、PH、SG、TH 或 VN。results_limit 默认 50,可填 1–200 之间的整数。每件商品计 0.5 积分。

region
enum<string>
必填

TikTok Shop 市场代码:ID、JP、MX、MY、PH、SG、TH 或 VN。

可用选项:
ID,
JP,
MX,
MY,
PH,
SG,
TH,
VN
Minimum string length: 1
callback_url
string<uri>

可选的任务完成回调 URL。

results_limit
integer
默认值:50

最多保存的结果数,实际结果可能少于该值。

必填范围: 1 <= x <= 200

响应

任务已受理

code
integer

HTTP 业务状态码。

data
object