Lingxing
切换旧版

查询Shopee在线商品

POST/basicOpen/multiplatform/shopee/list

查询Shopee在线商品列表，对应系统【在线商品】>【多平台】>【Shopee】数据

接口信息

API Path请求协议请求方式令牌桶容量
/basicOpen/multiplatform/shopee/listHTTPSPOST1

请求参数

principalUidsarray<any>
负责人用户ID列表；传[-1]表示仅查询未分配负责人，-1不能与其他UID混传
offsetinteger
偏移量，默认0
lengthinteger
每页数量，默认20，最大1000
storeIdsarray<any>
店铺ID列表
pairingStatusinteger
配对状态：
0=未配对
1=已配对
searchSingleValuestring
搜索值（单个）
searchValuesarray<any>
搜索值列表（精确搜索）
searchFieldinteger
搜索类型：
1=商品ID子体
2=商品ID父体
3=msku子体
4=标题
5=品名
6=local_sku
7=父体msku
sortTypestring
排序方式：asc/desc
sortFieldstring
排序字段
categoryIdsarray<any>
分类ID列表
brandIdsarray<any>
品牌ID列表
statusListarray<any>
状态筛选：
1=可售
0=不可售
siteCodesarray<any>
站点代码：
SG/MY/VN/TW/PH/TH/ID/BR/MX/CO/CL/PL/ES/FR
timeFieldinteger
时间字段
startTimestring
开始时间
endTimestring
结束时间
priceValuenumber
价格值
priceOpstring
价格比较操作符
currentPriceValuenumber
当前价格值
currentPriceOpstring
当前价格比较操作符
inventoryValueinteger
库存值
inventoryOpstring
库存比较操作符
saleValueinteger
销量值
saleOpstring
销量比较操作符
viewsValueinteger
浏览量值
viewsOpstring
浏览量比较操作符
likesValueinteger
点赞数值
likesOpstring
点赞数比较操作符
ratingStarValuenumber
评分值
ratingStarOpstring
评分比较操作符
commentCountValueinteger
评论数值
commentCountOpstring
评论数比较操作符

请求cURL示例

curl --location 'https://openapi.lingxing.com/basicOpen/multiplatform/shopee/list?access_token=value&timestamp=value&sign=value&app_key=value' \
--header 'Content-Type: application/json' \
--data '{
    "offset": 0,
    "length": 20,
    "principalUids": [10001],
    "storeIds": [1, 2],
    "searchField": 3,
    "searchSingleValue": "商品A",
    "siteCodes": ["SG", "MY"],
    "statusList": [1]
}'

返回结果

Json Object

codeinteger必填
状态码，0：成功
示例 0
messagestring必填
消息提示
示例 success
error_detailsarray<any>必填
数据校验失败时的错误详情
request_idstring必填
请求链路id
示例 a0d54debf93140f3b58d1ed81e8e3583
response_timestring必填
响应时间
示例 2026-07-14 12:00:00
dataobject必填
响应数据
隐藏子属性
countinteger必填
总数
示例 60
listarray<object>必填
列表数据
隐藏子属性
principalUidsarray<any>
负责人用户ID列表
示例 [10001]
principalNamestring
负责人名称
示例 张三
performanceUidinteger
业绩归属人用户ID
示例 10002
performanceNamestring
业绩归属人名称
示例 李四
idinteger必填
ID
示例 1
productUniqueIdinteger必填
商品唯一ID
示例 10001
variantUniqueIdinteger必填
变体唯一ID
示例 20001
rowTypestring必填
行类型
示例 parent
itemIdinteger必填
商品ID
示例 123456789
modelIdinteger必填
型号ID
示例 987654321
parentMskustring必填
父体MSKU
示例 P-MSKU001
displayItemIdstring必填
展示商品ID
示例 123456789
displayMskustring必填
展示MSKU
示例 MSKU001
imgUrlstring必填
图片链接
示例 https://img.example.com/1.jpg
itemStatusDisplaystring必填
商品状态显示
示例 在售
itemStatusTagstring必填
商品状态标签
示例 normal
modelStatusDisplaystring必填
型号状态显示
示例 在售
specDisplaystring必填
规格显示
示例 红色/XL
originalPricenumber必填
原价
示例 19.9
currentPricenumber必填
当前价格
示例 15.9
currencystring必填
货币
示例 SGD
currencyIconstring必填
货币符号
示例 S$
usableInventoryinteger必填
可用库存
示例 200
saleinteger必填
销量
示例 500
viewsinteger必填
浏览量
示例 5000
likesinteger必填
点赞数
示例 100
ratingStarstring必填
评分
示例 4.8
commentCountinteger必填
评论数
示例 50
createTimestring必填
创建时间
示例 2026-01-01 10:00:00
updateTimestring必填
更新时间
示例 2026-01-05 10:00:00
siteNamestring必填
站点名称
示例 Singapore
storeIdinteger必填
店铺ID
示例 1
storeNamestring必填
店铺名称
示例 我的店铺
mskuIdstring必填
MSKU ID
示例 MSKU001
mskustring必填
MSKU
示例 msku-test
pnamestring必填
品名
示例 商品A
skustring必填
SKU
示例 SKU001
pidinteger必填
本地商品ID
示例 1001
childrenarray<any>必填
子体列表
totalinteger必填
总数
示例 60

返回成功示例

{
    "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.90,
                "currentPrice": 15.90,
                "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
}