轻易云
注册体验

领星ERP查询Shopee在线商品接口

所属平台
领星ERP
类型
WebAPI
作用
QUERY
接口版本
1.0
适配器
\Adapter\LingXing\LXQueryAdapter
授权方式
OTHER
描述
多平台 · POST · 请求参数 33 个(必填 0) · 响应参数 48 个 · 限流令牌桶容量 1
更新日期
2026-11-21

查询Shopee在线商品

POST/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&timestamp=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
  }
}

接口请求参数

序号字段名称类型默认值必填描述
1principalUids负责人用户ID列表array<any>—可选负责人用户ID列表;传[-1]表示仅查询未分配负责人,-1不能与其他UID混传
2offset偏移量integer—可选偏移量,默认0
3length每页数量integer—可选每页数量,默认20,最大1000
4storeIds店铺ID列表array<any>—可选店铺ID列表
5pairingStatus配对状态integer—可选配对状态: 0=未配对 1=已配对
6searchSingleValue搜索值(单个)string—可选搜索值(单个)
7searchValues搜索值列表(精确搜索)array<any>—可选搜索值列表(精确搜索)
8searchField搜索类型integer—可选搜索类型: 1=商品ID子体 2=商品ID父体 3=msku子体 4=标题 5=品名 6=local_sku 7=父体msku
9sortType排序方式string—可选排序方式:asc/desc
10sortField排序字段string—可选排序字段
11categoryIds分类ID列表array<any>—可选分类ID列表
12brandIds品牌ID列表array<any>—可选品牌ID列表
13statusList状态筛选array<any>—可选状态筛选: 1=可售 0=不可售
14siteCodes站点代码array<any>—可选站点代码: SG/MY/VN/TW/PH/TH/ID/BR/MX/CO/CL/PL/ES/FR
15timeField时间字段integer—可选时间字段
16startTime开始时间string—可选开始时间
17endTime结束时间string—可选结束时间
18priceValue价格值number—可选价格值
19priceOp价格比较操作符string—可选价格比较操作符
20currentPriceValue当前价格值number—可选当前价格值
21currentPriceOp当前价格比较操作符string—可选当前价格比较操作符
22inventoryValue库存值integer—可选库存值
23inventoryOp库存比较操作符string—可选库存比较操作符
24saleValue销量值integer—可选销量值
25saleOp销量比较操作符string—可选销量比较操作符
26viewsValue浏览量值integer—可选浏览量值
27viewsOp浏览量比较操作符string—可选浏览量比较操作符
28likesValue点赞数值integer—可选点赞数值
29likesOp点赞数比较操作符string—可选点赞数比较操作符
30ratingStarValue评分值number—可选评分值
31ratingStarOp评分比较操作符string—可选评分比较操作符
32commentCountValue评论数值integer—可选评论数值
33commentCountOp评论数比较操作符string—可选评论数比较操作符

接口响应参数

序号字段名称类型默认值必填描述
1code状态码integer0必填状态码,0:成功
2message消息提示stringsuccess必填消息提示
3error_details数据校验失败时的错误详情array<any>—必填数据校验失败时的错误详情
4request_id请求链路idstringa0d54debf93140f3b58d1ed81e8e3583必填请求链路id
5response_time响应时间string2026-07-14 12:00:00必填响应时间
6data响应数据object—必填响应数据
6.1count总数integer60必填总数
6.2list列表数据array<object>—必填列表数据
6.2.1principalUids负责人用户ID列表array<any>[10001]可选负责人用户ID列表
6.2.2principalName负责人名称string张三可选负责人名称
6.2.3performanceUid业绩归属人用户IDinteger10002可选业绩归属人用户ID
6.2.4performanceName业绩归属人名称string李四可选业绩归属人名称
6.2.5ididinteger1必填ID
6.2.6productUniqueId商品唯一IDinteger10001必填商品唯一ID
6.2.7variantUniqueId变体唯一IDinteger20001必填变体唯一ID
6.2.8rowType行类型stringparent必填行类型
6.2.9itemId商品IDinteger123456789必填商品ID
6.2.10modelId型号IDinteger987654321必填型号ID
6.2.11parentMsku父体MSKUstringP-MSKU001必填父体MSKU
6.2.12displayItemId展示商品IDstring123456789必填展示商品ID
6.2.13displayMsku展示MSKUstringMSKU001必填展示MSKU
6.2.14imgUrl图片链接stringhttps://img.example.com/1.jpg必填图片链接
6.2.15itemStatusDisplay商品状态显示string在售必填商品状态显示
6.2.16itemStatusTag商品状态标签stringnormal必填商品状态标签
6.2.17modelStatusDisplay型号状态显示string在售必填型号状态显示
6.2.18specDisplay规格显示string红色/XL必填规格显示
6.2.19originalPrice原价number19.9必填原价
6.2.20currentPrice当前价格number15.9必填当前价格
6.2.21currency货币stringSGD必填货币
6.2.22currencyIcon货币符号stringS$必填货币符号
6.2.23usableInventory可用库存integer200必填可用库存
6.2.24sale销量integer500必填销量
6.2.25views浏览量integer5000必填浏览量
6.2.26likes点赞数integer100必填点赞数
6.2.27ratingStar评分string4.8必填评分
6.2.28commentCount评论数integer50必填评论数
6.2.29createTime创建时间string2026-01-01 10:00:00必填创建时间
6.2.30updateTime更新时间string2026-01-05 10:00:00必填更新时间
6.2.31siteName站点名称stringSingapore必填站点名称
6.2.32storeId店铺IDinteger1必填店铺ID
6.2.33storeName店铺名称string我的店铺必填店铺名称
6.2.34mskuIdMSKU IDstringMSKU001必填MSKU ID
6.2.35mskumskustringmsku-test必填MSKU
6.2.36pname品名string商品A必填品名
6.2.37skuskustringSKU001必填SKU
6.2.38pid本地商品IDinteger1001必填本地商品ID
6.2.39children子体列表array<any>—必填子体列表
7total总数integer60必填总数

领星ERP的接口:查询Shopee在线商品(/basicOpen/multiplatform/shopee/list),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。

需要对接这个接口?

轻易云已预置该接口的适配能力,联系我们即可开始配置数据集成。