/basicOpen/multiplatform/shopee/list{
"operation": {
"method": "POST",
"path": "/basicOpen/multiplatform/shopee/list"
},
"protocol": "HTTPS",
"host": "https://openapi.lingxing.com",
"rateLimit": {
"tokenBucketCapacity": 1,
"text": ""
},
"requestExample": "curl --location 'https://openapi.lingxing.com/basicOpen/multiplatform/shopee/list?access_token=value×tamp=value&sign=value&app_key=value' \\\n--header 'Content-Type: application/json' \\\n--data '{\n \"offset\": 0,\n \"length\": 20,\n \"principalUids\": [10001],\n \"storeIds\": [1, 2],\n \"searchField\": 3,\n \"searchSingleValue\": \"商品A\",\n \"siteCodes\": [\"SG\", \"MY\"],\n \"statusList\": [1]\n}'",
"responseExample": {
"code": 0,
"message": "success",
"error_details": [],
"request_id": "a0d54debf93140f3b58d1ed81e8e3583",
"response_time": "2026-07-14 12:00:00",
"data": {
"count": 60,
"list": [
{
"id": 1,
"productUniqueId": 10001,
"principalUids": [
10001
],
"principalName": "张三",
"performanceUid": 10002,
"performanceName": "李四",
"variantUniqueId": 20001,
"rowType": "parent",
"itemId": 123456789,
"modelId": 987654321,
"parentMsku": "P-MSKU001",
"displayItemId": "123456789",
"displayMsku": "MSKU001",
"imgUrl": "https://img.example.com/1.jpg",
"itemStatusDisplay": "在售",
"itemStatusTag": "normal",
"modelStatusDisplay": "在售",
"specDisplay": "红色/XL",
"originalPrice": 19.9,
"currentPrice": 15.9,
"currency": "SGD",
"currencyIcon": "S$",
"usableInventory": 200,
"sale": 500,
"views": 5000,
"likes": 100,
"ratingStar": "4.8",
"commentCount": 50,
"createTime": "2026-01-01 10:00:00",
"updateTime": "2026-01-05 10:00:00",
"siteName": "Singapore",
"storeId": 1,
"storeName": "我的店铺",
"mskuId": "MSKU001",
"msku": "msku-test",
"pname": "商品A",
"sku": "SKU001",
"pid": 1001,
"children": []
}
]
},
"total": 60
}
}| 序号 | 字段 | 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| 1 | principalUids | 负责人用户ID列表 | array<any> | — | 可选 | 负责人用户ID列表;传[-1]表示仅查询未分配负责人,-1不能与其他UID混传 |
| 2 | offset | 偏移量 | integer | — | 可选 | 偏移量,默认0 |
| 3 | length | 每页数量 | integer | — | 可选 | 每页数量,默认20,最大1000 |
| 4 | storeIds | 店铺ID列表 | array<any> | — | 可选 | 店铺ID列表 |
| 5 | pairingStatus | 配对状态 | integer | — | 可选 | 配对状态: 0=未配对 1=已配对 |
| 6 | searchSingleValue | 搜索值(单个) | string | — | 可选 | 搜索值(单个) |
| 7 | searchValues | 搜索值列表(精确搜索) | array<any> | — | 可选 | 搜索值列表(精确搜索) |
| 8 | searchField | 搜索类型 | integer | — | 可选 | 搜索类型: 1=商品ID子体 2=商品ID父体 3=msku子体 4=标题 5=品名 6=local_sku 7=父体msku |
| 9 | sortType | 排序方式 | string | — | 可选 | 排序方式:asc/desc |
| 10 | sortField | 排序字段 | string | — | 可选 | 排序字段 |
| 11 | categoryIds | 分类ID列表 | array<any> | — | 可选 | 分类ID列表 |
| 12 | brandIds | 品牌ID列表 | array<any> | — | 可选 | 品牌ID列表 |
| 13 | statusList | 状态筛选 | array<any> | — | 可选 | 状态筛选: 1=可售 0=不可售 |
| 14 | siteCodes | 站点代码 | array<any> | — | 可选 | 站点代码: SG/MY/VN/TW/PH/TH/ID/BR/MX/CO/CL/PL/ES/FR |
| 15 | timeField | 时间字段 | integer | — | 可选 | 时间字段 |
| 16 | startTime | 开始时间 | string | — | 可选 | 开始时间 |
| 17 | endTime | 结束时间 | string | — | 可选 | 结束时间 |
| 18 | priceValue | 价格值 | number | — | 可选 | 价格值 |
| 19 | priceOp | 价格比较操作符 | string | — | 可选 | 价格比较操作符 |
| 20 | currentPriceValue | 当前价格值 | number | — | 可选 | 当前价格值 |
| 21 | currentPriceOp | 当前价格比较操作符 | string | — | 可选 | 当前价格比较操作符 |
| 22 | inventoryValue | 库存值 | integer | — | 可选 | 库存值 |
| 23 | inventoryOp | 库存比较操作符 | string | — | 可选 | 库存比较操作符 |
| 24 | saleValue | 销量值 | integer | — | 可选 | 销量值 |
| 25 | saleOp | 销量比较操作符 | string | — | 可选 | 销量比较操作符 |
| 26 | viewsValue | 浏览量值 | integer | — | 可选 | 浏览量值 |
| 27 | viewsOp | 浏览量比较操作符 | string | — | 可选 | 浏览量比较操作符 |
| 28 | likesValue | 点赞数值 | integer | — | 可选 | 点赞数值 |
| 29 | likesOp | 点赞数比较操作符 | string | — | 可选 | 点赞数比较操作符 |
| 30 | ratingStarValue | 评分值 | number | — | 可选 | 评分值 |
| 31 | ratingStarOp | 评分比较操作符 | string | — | 可选 | 评分比较操作符 |
| 32 | commentCountValue | 评论数值 | integer | — | 可选 | 评论数值 |
| 33 | commentCountOp | 评论数比较操作符 | string | — | 可选 | 评论数比较操作符 |
| 序号 | 字段 | 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| 1 | code | 状态码 | integer | 0 | 必填 | 状态码,0:成功 |
| 2 | message | 消息提示 | string | success | 必填 | 消息提示 |
| 3 | error_details | 数据校验失败时的错误详情 | array<any> | — | 必填 | 数据校验失败时的错误详情 |
| 4 | request_id | 请求链路id | string | a0d54debf93140f3b58d1ed81e8e3583 | 必填 | 请求链路id |
| 5 | response_time | 响应时间 | string | 2026-07-14 12:00:00 | 必填 | 响应时间 |
| 6 | data | 响应数据 | object | — | 必填 | 响应数据 |
| 6.1 | count | 总数 | integer | 60 | 必填 | 总数 |
| 6.2 | list | 列表数据 | array<object> | — | 必填 | 列表数据 |
| 6.2.1 | principalUids | 负责人用户ID列表 | array<any> | [10001] | 可选 | 负责人用户ID列表 |
| 6.2.2 | principalName | 负责人名称 | string | 张三 | 可选 | 负责人名称 |
| 6.2.3 | performanceUid | 业绩归属人用户ID | integer | 10002 | 可选 | 业绩归属人用户ID |
| 6.2.4 | performanceName | 业绩归属人名称 | string | 李四 | 可选 | 业绩归属人名称 |
| 6.2.5 | id | id | integer | 1 | 必填 | ID |
| 6.2.6 | productUniqueId | 商品唯一ID | integer | 10001 | 必填 | 商品唯一ID |
| 6.2.7 | variantUniqueId | 变体唯一ID | integer | 20001 | 必填 | 变体唯一ID |
| 6.2.8 | rowType | 行类型 | string | parent | 必填 | 行类型 |
| 6.2.9 | itemId | 商品ID | integer | 123456789 | 必填 | 商品ID |
| 6.2.10 | modelId | 型号ID | integer | 987654321 | 必填 | 型号ID |
| 6.2.11 | parentMsku | 父体MSKU | string | P-MSKU001 | 必填 | 父体MSKU |
| 6.2.12 | displayItemId | 展示商品ID | string | 123456789 | 必填 | 展示商品ID |
| 6.2.13 | displayMsku | 展示MSKU | string | MSKU001 | 必填 | 展示MSKU |
| 6.2.14 | imgUrl | 图片链接 | string | https://img.example.com/1.jpg | 必填 | 图片链接 |
| 6.2.15 | itemStatusDisplay | 商品状态显示 | string | 在售 | 必填 | 商品状态显示 |
| 6.2.16 | itemStatusTag | 商品状态标签 | string | normal | 必填 | 商品状态标签 |
| 6.2.17 | modelStatusDisplay | 型号状态显示 | string | 在售 | 必填 | 型号状态显示 |
| 6.2.18 | specDisplay | 规格显示 | string | 红色/XL | 必填 | 规格显示 |
| 6.2.19 | originalPrice | 原价 | number | 19.9 | 必填 | 原价 |
| 6.2.20 | currentPrice | 当前价格 | number | 15.9 | 必填 | 当前价格 |
| 6.2.21 | currency | 货币 | string | SGD | 必填 | 货币 |
| 6.2.22 | currencyIcon | 货币符号 | string | S$ | 必填 | 货币符号 |
| 6.2.23 | usableInventory | 可用库存 | integer | 200 | 必填 | 可用库存 |
| 6.2.24 | sale | 销量 | integer | 500 | 必填 | 销量 |
| 6.2.25 | views | 浏览量 | integer | 5000 | 必填 | 浏览量 |
| 6.2.26 | likes | 点赞数 | integer | 100 | 必填 | 点赞数 |
| 6.2.27 | ratingStar | 评分 | string | 4.8 | 必填 | 评分 |
| 6.2.28 | commentCount | 评论数 | integer | 50 | 必填 | 评论数 |
| 6.2.29 | createTime | 创建时间 | string | 2026-01-01 10:00:00 | 必填 | 创建时间 |
| 6.2.30 | updateTime | 更新时间 | string | 2026-01-05 10:00:00 | 必填 | 更新时间 |
| 6.2.31 | siteName | 站点名称 | string | Singapore | 必填 | 站点名称 |
| 6.2.32 | storeId | 店铺ID | integer | 1 | 必填 | 店铺ID |
| 6.2.33 | storeName | 店铺名称 | string | 我的店铺 | 必填 | 店铺名称 |
| 6.2.34 | mskuId | MSKU ID | string | MSKU001 | 必填 | MSKU ID |
| 6.2.35 | msku | msku | string | msku-test | 必填 | MSKU |
| 6.2.36 | pname | 品名 | string | 商品A | 必填 | 品名 |
| 6.2.37 | sku | sku | string | SKU001 | 必填 | SKU |
| 6.2.38 | pid | 本地商品ID | integer | 1001 | 必填 | 本地商品ID |
| 6.2.39 | children | 子体列表 | array<any> | — | 必填 | 子体列表 |
| 7 | total | 总数 | integer | 60 | 必填 | 总数 |
领星ERP的接口:查询Shopee在线商品(/basicOpen/multiplatform/shopee/list),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。