# 查询店铺商品

- API 版本：1.10.0
- 最后更新：2026-09-29
- 服务地址：`https://api.ailingtu.com`
- 网页文档：[查询店铺商品](/openapi/shop-products)
- 完整接口约束：[JSON Schema](/openapi/operations/listTikTokShopProducts.json)
- 接口发现：[接口索引](/openapi/operations/index.json)

## GET /v1/creator/tiktokshop/product/listByShop

接口标识：`listTikTokShopProducts`

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

鉴权：请求头 `x-api-key: <YOUR_API_KEY>`；密钥仅保存在服务端。

成功判断：HTTP 2xx 且响应 code=0；异步任务还需查询最终状态。

### 请求参数

| 字段 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| `pageSize` | query | integer | 是 | 每页条数 |
| `id` | query | integer | 是 | 创作者ID |
| `pageToken` | query | string | 否 | 分页令牌（首次请求传 null） |
| `titleKeyword` | query | string | 否 | 搜索关键词 |
| `sortField` | query | string | 否 | 排序字段（如 PRODUCT_ID, PRICE 等） |
| `sortOrder` | query | string | 否 | 排序方向（DESC 或 ASC） |

### 响应字段

以下列出主要层级；完整结构、联合类型及校验规则以接口 JSON Schema 为准。必填指字段所在对象中的约束。

| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| `code` | integer | 是 | — |
| `message` | string | 是 | — |
| `data` | object | 是 | 商品响应字段尚待确认，请以实际响应为准，不要推断未确认字段。 |
| `timestamp` | integer | 是 | — |