Lingxing
切换旧版

查询Coupang在线商品

POST/basicOpen/multiplatform/coupang/list

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

接口信息

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

请求参数

principalUidsarray<any>
负责人用户ID列表；传[-1]表示仅查询未分配负责人，-1不能与其他UID混传
offsetinteger
偏移量，默认0
lengthinteger
每页条数，默认20，最大200
storeIdsarray<any>
店铺ID列表
pairingStatusinteger
配对状态
0=未配对
1=已配对
searchSingleValuestring
模糊搜索值
searchValuesarray<any>
精确搜索值列表
searchFieldinteger
搜索字段：
1=父体sellerProductId
2=标题
3=商品ID/vendorItemId
4=MSKU
5=本地SKU
6=品名
sortTypestring
排序方式：asc/desc
sortFieldstring
排序字段
categoryIdsarray<any>
分类ID列表
brandIdsarray<any>
品牌ID列表
statusListarray<any>
状态列表
timeFieldinteger
时间类型：
1=创建时间
2=更新时间
startTimestring
开始时间（yyyy-MM-dd HH:mm:ss）
endTimestring
结束时间（yyyy-MM-dd HH:mm:ss）
priceValuenumber
价格筛选值
priceOpstring
价格筛选条件：gt/lt/eq
originalPriceValuenumber
原价筛选值
originalPriceOpstring
原价筛选条件：gt/lt/eq
inventoryValueinteger
库存筛选值
inventoryOpstring
库存筛选条件：gt/lt/eq
shippingModeListarray<any>
发货模式筛选(父行维度)：
空/null=自发货
RFM=火箭仓
NORMAL=自发货/火箭仓

请求cURL示例

curl --location 'https://openapi.lingxing.com/basicOpen/multiplatform/coupang/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],
    "pairingStatus": 1,
    "searchField": 4,
    "searchSingleValue": "商品A"
}'

返回结果

Json Object

codeinteger必填
状态码，0：成功
示例 0
messagestring必填
消息提示
示例 success
error_detailsarray<any>必填
数据校验失败时的错误详情
request_idstring必填
请求链路id
示例 a0d54debf93140f3b58d1ed81e8e3583
response_timestring必填
响应时间
示例 2026-07-14 12:00:00
dataobject必填
响应数据
隐藏子属性
countinteger必填
总数
示例 50
listarray<object>必填
列表数据
隐藏子属性
principalUidsarray<any>
负责人用户ID列表
示例 [10001]
principalNamestring
负责人名称
示例 张三
performanceUidinteger
业绩归属人用户ID
示例 10002
performanceNamestring
业绩归属人名称
示例 李四
idinteger必填
ID
示例 1
productUniqueIdinteger必填
商品唯一ID
示例 10001
variantUniqueIdinteger必填
子体维度分布式ID
示例 20001
rowTypestring必填
行类型：parent/child
示例 parent
sellerProductIdstring必填
父体商品ID
示例 SP001
vendorItemIdstring必填
商品ID Option ID
示例 VI001
sellerProductItemIdstring必填
sellerProductItemId
示例 SPI001
itemIdstring必填
itemId
示例 ITEM001
mskuIdstring必填
MSKU ID
示例 MSKU001
mskustring必填
MSKU
示例 msku-test
titlestring必填
标题
示例 示例商品标题
productStatusstring必填
父体状态
示例 ACTIVE
productStatusDisplaystring必填
父体状态中文
示例 销售中
registrationTypeDisplaystring必填
发货模式(父行)：自发货/火箭仓/自发货/火箭仓
示例 自发货
shippingModeDisplaystring必填
发货方式(子行)：自发货/火箭仓
示例 自发货
shippingModestring必填
子行发货方式原始值
示例 NORMAL
inventoryReadOnlyboolean必填
火箭仓行库存是否不可编辑
示例 false
itemNamestring必填
变体属性
示例 红色/XL
imgUrlstring必填
图片URL
示例 https://img.example.com/1.jpg
maximumBuyCountinteger必填
库存
示例 100
salePricenumber必填
售价
示例 29900
originalPricenumber必填
原价
示例 39900
currencystring必填
币种
示例 KRW
currencyIconstring必填
币种符号
示例 ₩
createTimestring必填
创建时间
示例 2026-01-01 10:00:00
updateTimestring必填
更新时间
示例 2026-01-05 10:00:00
storeIdinteger必填
店铺ID
示例 1
storeNamestring必填
店铺名称
示例 我的店铺
pnamestring必填
品名
示例 商品A
skustring必填
SKU
示例 SKU001
pidinteger必填
本地产品ID
示例 1001
childrenarray<any>必填
子行列表
totalinteger必填
总数
示例 50

返回成功示例

{
    "code": 0,
    "message": "success",
    "error_details": [],
    "request_id": "a0d54debf93140f3b58d1ed81e8e3583",
    "response_time": "2026-07-14 12:00:00",
    "data": {
        "count": 50,
        "list": [
            {
                "id": 1,
                "productUniqueId": 10001,
                "principalUids": [10001],
                "principalName": "张三",
                "performanceUid": 10002,
                "performanceName": "李四",
                "variantUniqueId": 20001,
                "rowType": "parent",
                "sellerProductId": "SP001",
                "vendorItemId": "VI001",
                "sellerProductItemId": "SPI001",
                "itemId": "ITEM001",
                "mskuId": "MSKU001",
                "msku": "msku-test",
                "title": "示例商品标题",
                "productStatus": "ACTIVE",
                "productStatusDisplay": "销售中",
                "registrationTypeDisplay": "自发货",
                "shippingModeDisplay": "自发货",
                "shippingMode": "NORMAL",
                "inventoryReadOnly": false,
                "itemName": "红色/XL",
                "imgUrl": "https://img.example.com/1.jpg",
                "maximumBuyCount": 100,
                "salePrice": 29900,
                "originalPrice": 39900,
                "currency": "KRW",
                "currencyIcon": "₩",
                "createTime": "2026-01-01 10:00:00",
                "updateTime": "2026-01-05 10:00:00",
                "storeId": 1,
                "storeName": "我的店铺",
                "pname": "商品A",
                "sku": "SKU001",
                "pid": 1001,
                "children": []
            }
        ]
    },
    "total": 50
}