您的浏览器不支持JavaScript,请启用JavaScript以获得最佳体验。
查询店铺商品
开发者文档 / 带货内容发布

查询店铺商品

查询店铺商品,支持关键词、排序及分页;响应 data 的字段结构待确认。

GET/v1/creator/tiktokshop/product/listByShop
鉴权:
请求头 x-api-key: <YOUR_API_KEY>;密钥仅保存在服务端。
成功判断:
HTTP 2xx 且响应 code=0;异步任务还需查询最终状态。

Query 参数

字段 类型 必填 说明
pageSizeinteger是每页条数
idinteger是创作者ID
pageTokenstring否分页令牌(首次请求传 null)
titleKeywordstring否搜索关键词
sortFieldstring否排序字段(如 PRODUCT_ID, PRICE 等)
sortOrderstring否排序方向(DESC 或 ASC)

响应与错误

主要响应字段来自接口规范;完整层级、联合类型和校验规则见 JSON Schema。必填指字段所在对象中的约束。

字段类型必填说明
codeinteger是—
messagestring是—
dataobject是商品响应字段尚待确认,请以实际响应为准,不要推断未确认字段。
timestampinteger是—

参数、权限或授权错误需先修正。创建发布或生成任务超时后先查询已有任务,避免重复创建;不要因轮询中断而重复提交。

最后更新 · 2026-09-29