Qeasy Cloud
Get Started

领星ERP 查询Shopee在线商品 API

Platform
领星ERP
Type
WebAPI
Effect
QUERY
API Version
1.0
Adapter
\Adapter\LingXing\LXQueryAdapter
Auth Mode
OTHER
Description
多平台 · POST · 请求参数 33 个(必填 0) · 响应参数 48 个 · 限流令牌桶容量 1
Updated At
2026-11-21

查询Shopee在线商品

POST/basicOpen/multiplatform/shopee/list
Factory
{
  "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
  }
}

Request Parameters

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

Response Parameters

No.FieldNameTypeDefaultRequiredDescription
1code状态码integer0Required状态码,0:成功
2message消息提示stringsuccessRequired消息提示
3error_details数据校验失败时的错误详情array<any>—Required数据校验失败时的错误详情
4request_id请求链路idstringa0d54debf93140f3b58d1ed81e8e3583Required请求链路id
5response_time响应时间string2026-07-14 12:00:00Required响应时间
6data响应数据object—Required响应数据
6.1count总数integer60Required总数
6.2list列表数据array<object>—Required列表数据
6.2.1principalUids负责人用户ID列表array<any>[10001]Optional负责人用户ID列表
6.2.2principalName负责人名称string张三Optional负责人名称
6.2.3performanceUid业绩归属人用户IDinteger10002Optional业绩归属人用户ID
6.2.4performanceName业绩归属人名称string李四Optional业绩归属人名称
6.2.5ididinteger1RequiredID
6.2.6productUniqueId商品唯一IDinteger10001Required商品唯一ID
6.2.7variantUniqueId变体唯一IDinteger20001Required变体唯一ID
6.2.8rowType行类型stringparentRequired行类型
6.2.9itemId商品IDinteger123456789Required商品ID
6.2.10modelId型号IDinteger987654321Required型号ID
6.2.11parentMsku父体MSKUstringP-MSKU001Required父体MSKU
6.2.12displayItemId展示商品IDstring123456789Required展示商品ID
6.2.13displayMsku展示MSKUstringMSKU001Required展示MSKU
6.2.14imgUrl图片链接stringhttps://img.example.com/1.jpgRequired图片链接
6.2.15itemStatusDisplay商品状态显示string在售Required商品状态显示
6.2.16itemStatusTag商品状态标签stringnormalRequired商品状态标签
6.2.17modelStatusDisplay型号状态显示string在售Required型号状态显示
6.2.18specDisplay规格显示string红色/XLRequired规格显示
6.2.19originalPrice原价number19.9Required原价
6.2.20currentPrice当前价格number15.9Required当前价格
6.2.21currency货币stringSGDRequired货币
6.2.22currencyIcon货币符号stringS$Required货币符号
6.2.23usableInventory可用库存integer200Required可用库存
6.2.24sale销量integer500Required销量
6.2.25views浏览量integer5000Required浏览量
6.2.26likes点赞数integer100Required点赞数
6.2.27ratingStar评分string4.8Required评分
6.2.28commentCount评论数integer50Required评论数
6.2.29createTime创建时间string2026-01-01 10:00:00Required创建时间
6.2.30updateTime更新时间string2026-01-05 10:00:00Required更新时间
6.2.31siteName站点名称stringSingaporeRequired站点名称
6.2.32storeId店铺IDinteger1Required店铺ID
6.2.33storeName店铺名称string我的店铺Required店铺名称
6.2.34mskuIdMSKU IDstringMSKU001RequiredMSKU ID
6.2.35mskumskustringmsku-testRequiredMSKU
6.2.36pname品名string商品ARequired品名
6.2.37skuskustringSKU001RequiredSKU
6.2.38pid本地商品IDinteger1001Required本地商品ID
6.2.39children子体列表array<any>—Required子体列表
7total总数integer60Required总数

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.

Need to integrate this API?

Qeasy ships with prebuilt adaptation for this API — contact us to start configuring data integration.