开发者文档 / 带货内容发布
查询店铺商品
查询店铺商品,支持关键词、排序及分页;响应 data 的字段结构待确认。
GET
/v1/creator/tiktokshop/product/listByShop- 鉴权:
- 请求头 x-api-key: <YOUR_API_KEY>;密钥仅保存在服务端。
- 成功判断:
- HTTP 2xx 且响应 code=0;异步任务还需查询最终状态。
Query 参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
pageSize | integer | 是 | 每页条数 |
id | integer | 是 | 创作者ID |
pageToken | string | 否 | 分页令牌(首次请求传 null) |
titleKeyword | string | 否 | 搜索关键词 |
sortField | string | 否 | 排序字段(如 PRODUCT_ID, PRICE 等) |
sortOrder | string | 否 | 排序方向(DESC 或 ASC) |
响应与错误
主要响应字段来自接口规范;完整层级、联合类型和校验规则见 JSON Schema。必填指字段所在对象中的约束。
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
code | integer | 是 | — |
message | string | 是 | — |
data | object | 是 | 商品响应字段尚待确认,请以实际响应为准,不要推断未确认字段。 |
timestamp | integer | 是 | — |
参数、权限或授权错误需先修正。创建发布或生成任务超时后先查询已有任务,避免重复创建;不要因轮询中断而重复提交。
最后更新 · 2026-09-29