/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
}
}| No. | Field | Name | Type | Default | Required | Description |
|---|---|---|---|---|---|---|
| 1 | principalUids | 负责人用户ID列表 | array<any> | — | Optional | 负责人用户ID列表;传[-1]表示仅查询未分配负责人,-1不能与其他UID混传 |
| 2 | offset | 偏移量 | integer | — | Optional | 偏移量,默认0 |
| 3 | length | 每页数量 | integer | — | Optional | 每页数量,默认20,最大1000 |
| 4 | storeIds | 店铺ID列表 | array<any> | — | Optional | 店铺ID列表 |
| 5 | pairingStatus | 配对状态 | integer | — | Optional | 配对状态: 0=未配对 1=已配对 |
| 6 | searchSingleValue | 搜索值(单个) | string | — | Optional | 搜索值(单个) |
| 7 | searchValues | 搜索值列表(精确搜索) | array<any> | — | Optional | 搜索值列表(精确搜索) |
| 8 | searchField | 搜索类型 | integer | — | Optional | 搜索类型: 1=商品ID子体 2=商品ID父体 3=msku子体 4=标题 5=品名 6=local_sku 7=父体msku |
| 9 | sortType | 排序方式 | string | — | Optional | 排序方式:asc/desc |
| 10 | sortField | 排序字段 | string | — | Optional | 排序字段 |
| 11 | categoryIds | 分类ID列表 | array<any> | — | Optional | 分类ID列表 |
| 12 | brandIds | 品牌ID列表 | array<any> | — | Optional | 品牌ID列表 |
| 13 | statusList | 状态筛选 | array<any> | — | Optional | 状态筛选: 1=可售 0=不可售 |
| 14 | siteCodes | 站点代码 | array<any> | — | Optional | 站点代码: SG/MY/VN/TW/PH/TH/ID/BR/MX/CO/CL/PL/ES/FR |
| 15 | timeField | 时间字段 | integer | — | Optional | 时间字段 |
| 16 | startTime | 开始时间 | string | — | Optional | 开始时间 |
| 17 | endTime | 结束时间 | string | — | Optional | 结束时间 |
| 18 | priceValue | 价格值 | number | — | Optional | 价格值 |
| 19 | priceOp | 价格比较操作符 | string | — | Optional | 价格比较操作符 |
| 20 | currentPriceValue | 当前价格值 | number | — | Optional | 当前价格值 |
| 21 | currentPriceOp | 当前价格比较操作符 | string | — | Optional | 当前价格比较操作符 |
| 22 | inventoryValue | 库存值 | integer | — | Optional | 库存值 |
| 23 | inventoryOp | 库存比较操作符 | string | — | Optional | 库存比较操作符 |
| 24 | saleValue | 销量值 | integer | — | Optional | 销量值 |
| 25 | saleOp | 销量比较操作符 | string | — | Optional | 销量比较操作符 |
| 26 | viewsValue | 浏览量值 | integer | — | Optional | 浏览量值 |
| 27 | viewsOp | 浏览量比较操作符 | string | — | Optional | 浏览量比较操作符 |
| 28 | likesValue | 点赞数值 | integer | — | Optional | 点赞数值 |
| 29 | likesOp | 点赞数比较操作符 | string | — | Optional | 点赞数比较操作符 |
| 30 | ratingStarValue | 评分值 | number | — | Optional | 评分值 |
| 31 | ratingStarOp | 评分比较操作符 | string | — | Optional | 评分比较操作符 |
| 32 | commentCountValue | 评论数值 | integer | — | Optional | 评论数值 |
| 33 | commentCountOp | 评论数比较操作符 | string | — | Optional | 评论数比较操作符 |
| No. | Field | Name | Type | Default | Required | Description |
|---|---|---|---|---|---|---|
| 1 | code | 状态码 | integer | 0 | Required | 状态码,0:成功 |
| 2 | message | 消息提示 | string | success | Required | 消息提示 |
| 3 | error_details | 数据校验失败时的错误详情 | array<any> | — | Required | 数据校验失败时的错误详情 |
| 4 | request_id | 请求链路id | string | a0d54debf93140f3b58d1ed81e8e3583 | Required | 请求链路id |
| 5 | response_time | 响应时间 | string | 2026-07-14 12:00:00 | Required | 响应时间 |
| 6 | data | 响应数据 | object | — | Required | 响应数据 |
| 6.1 | count | 总数 | integer | 60 | Required | 总数 |
| 6.2 | list | 列表数据 | array<object> | — | Required | 列表数据 |
| 6.2.1 | principalUids | 负责人用户ID列表 | array<any> | [10001] | Optional | 负责人用户ID列表 |
| 6.2.2 | principalName | 负责人名称 | string | 张三 | Optional | 负责人名称 |
| 6.2.3 | performanceUid | 业绩归属人用户ID | integer | 10002 | Optional | 业绩归属人用户ID |
| 6.2.4 | performanceName | 业绩归属人名称 | string | 李四 | Optional | 业绩归属人名称 |
| 6.2.5 | id | id | integer | 1 | Required | ID |
| 6.2.6 | productUniqueId | 商品唯一ID | integer | 10001 | Required | 商品唯一ID |
| 6.2.7 | variantUniqueId | 变体唯一ID | integer | 20001 | Required | 变体唯一ID |
| 6.2.8 | rowType | 行类型 | string | parent | Required | 行类型 |
| 6.2.9 | itemId | 商品ID | integer | 123456789 | Required | 商品ID |
| 6.2.10 | modelId | 型号ID | integer | 987654321 | Required | 型号ID |
| 6.2.11 | parentMsku | 父体MSKU | string | P-MSKU001 | Required | 父体MSKU |
| 6.2.12 | displayItemId | 展示商品ID | string | 123456789 | Required | 展示商品ID |
| 6.2.13 | displayMsku | 展示MSKU | string | MSKU001 | Required | 展示MSKU |
| 6.2.14 | imgUrl | 图片链接 | string | https://img.example.com/1.jpg | Required | 图片链接 |
| 6.2.15 | itemStatusDisplay | 商品状态显示 | string | 在售 | Required | 商品状态显示 |
| 6.2.16 | itemStatusTag | 商品状态标签 | string | normal | Required | 商品状态标签 |
| 6.2.17 | modelStatusDisplay | 型号状态显示 | string | 在售 | Required | 型号状态显示 |
| 6.2.18 | specDisplay | 规格显示 | string | 红色/XL | Required | 规格显示 |
| 6.2.19 | originalPrice | 原价 | number | 19.9 | Required | 原价 |
| 6.2.20 | currentPrice | 当前价格 | number | 15.9 | Required | 当前价格 |
| 6.2.21 | currency | 货币 | string | SGD | Required | 货币 |
| 6.2.22 | currencyIcon | 货币符号 | string | S$ | Required | 货币符号 |
| 6.2.23 | usableInventory | 可用库存 | integer | 200 | Required | 可用库存 |
| 6.2.24 | sale | 销量 | integer | 500 | Required | 销量 |
| 6.2.25 | views | 浏览量 | integer | 5000 | Required | 浏览量 |
| 6.2.26 | likes | 点赞数 | integer | 100 | Required | 点赞数 |
| 6.2.27 | ratingStar | 评分 | string | 4.8 | Required | 评分 |
| 6.2.28 | commentCount | 评论数 | integer | 50 | Required | 评论数 |
| 6.2.29 | createTime | 创建时间 | string | 2026-01-01 10:00:00 | Required | 创建时间 |
| 6.2.30 | updateTime | 更新时间 | string | 2026-01-05 10:00:00 | Required | 更新时间 |
| 6.2.31 | siteName | 站点名称 | string | Singapore | Required | 站点名称 |
| 6.2.32 | storeId | 店铺ID | integer | 1 | Required | 店铺ID |
| 6.2.33 | storeName | 店铺名称 | string | 我的店铺 | Required | 店铺名称 |
| 6.2.34 | mskuId | MSKU ID | string | MSKU001 | Required | MSKU ID |
| 6.2.35 | msku | msku | string | msku-test | Required | MSKU |
| 6.2.36 | pname | 品名 | string | 商品A | Required | 品名 |
| 6.2.37 | sku | sku | string | SKU001 | Required | SKU |
| 6.2.38 | pid | 本地商品ID | integer | 1001 | Required | 本地商品ID |
| 6.2.39 | children | 子体列表 | array<any> | — | Required | 子体列表 |
| 7 | total | 总数 | integer | 60 | Required | 总数 |
The 查询Shopee在线商品 API (/basicOpen/multiplatform/shopee/list) of 领星ERP is curated by the API asset management module of the Qeasy Cloud data integration platform and kept in sync with 领星ERP version updates.
Qeasy ships with prebuilt adaptation for this API — contact us to start configuring data integration.