Lingxing
切换旧版

查询Mercado在线商品

POST/basicOpen/multiplatform/mercado/list

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

接口信息

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

请求参数

principalUidsarray<any>
负责人用户ID列表；传[-1]表示仅查询未分配负责人，-1不能与其他UID混传
offsetinteger
偏移量，默认0
lengthinteger
每页条数，默认20，最大200
storeIdsarray<any>
店铺ID列表
pairingStatusinteger
配对状态
0=未配对
1=已配对
searchSingleValuestring
模糊搜索值
searchValuesarray<any>
精确搜索值列表
searchFieldinteger
搜索字段：
1=商品ID
2=标题
3=变体ID
4=父体
5=Family Name
6=MSKU
7=SKU
8=品名
sortTypestring
排序方式：asc/desc
sortFieldstring
排序字段
categoryIdsarray<any>
分类ID列表
brandIdsarray<any>
品牌ID列表
productTypeinteger必填
商品类型
siteIdListarray<any>
站点ID列表
statusListarray<any>
状态列表
logisticTypeListarray<any>
物流类型列表
timeTypeinteger
时间筛选类型
startstring
开始时间(yyyy-MM-dd)
endstring
结束时间(yyyy-MM-dd)
pricenumber
金额筛选值
priceConditioninteger
金额筛选条件：
1=大于
2=小于
quantityinteger
库存数筛选值
quantityConditioninteger
库存筛选条件：
1=大于
2=小于

请求cURL示例

curl --location 'https://openapi.lingxing.com/basicOpen/multiplatform/mercado/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],
    "productType": 1,
    "searchField": 6,
    "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必填
总数
示例 35
listarray<object>必填
列表数据
隐藏子属性
principalUidsarray<any>
负责人用户ID列表
示例 [10001]
principalNamestring
负责人名称
示例 张三
performanceUidinteger
业绩归属人用户ID
示例 10002
performanceNamestring
业绩归属人名称
示例 李四
idinteger必填
ID
示例 1
productUniqueIdinteger必填
商品唯一ID
示例 10001
variantUniqueIdinteger必填
变体唯一ID
示例 20001
rowTypestring必填
行类型
示例 parent
itemIdstring必填
商品ID
示例 ITEM001
variationIdstring必填
变体ID
示例 VAR001
familyNamestring必填
Family Name
示例 Family-A
mskuIdstring必填
MSKU ID
示例 MSKU001
mskustring必填
MSKU
示例 msku-test
titlestring必填
标题
示例 示例商品标题
statusstring必填
状态
示例 active
statusNamestring必填
状态名称
示例 在售
siteNamestring必填
站点名称
示例 Brazil
siteCodestring必填
站点编码
示例 MLB
currencystring必填
币种
示例 BRL
currencyIconstring必填
币种符号
示例 R$
imgUrlstring必填
图片URL
示例 https://img.example.com/1.jpg
variantAttributestring必填
变体属性
示例 红色/XL
availableinteger必填
可用库存
示例 50
pricenumber必填
价格
示例 199.9
logisticTypestring必填
物流类型
示例 fulfillment
productTypestring必填
商品类型
示例 normal
urlstring必填
商品链接
示例 https://www.mercadolivre.com/item001
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必填
总数
示例 35

返回成功示例

{
    "code": 0,
    "message": "success",
    "error_details": [],
    "request_id": "a0d54debf93140f3b58d1ed81e8e3583",
    "response_time": "2026-07-14 12:00:00",
    "data": {
        "count": 35,
        "list": [
            {
                "id": 1,
                "productUniqueId": 10001,
                "principalUids": [10001],
                "principalName": "张三",
                "performanceUid": 10002,
                "performanceName": "李四",
                "variantUniqueId": 20001,
                "rowType": "parent",
                "itemId": "ITEM001",
                "variationId": "VAR001",
                "familyName": "Family-A",
                "mskuId": "MSKU001",
                "msku": "msku-test",
                "title": "示例商品标题",
                "status": "active",
                "statusName": "在售",
                "siteName": "Brazil",
                "siteCode": "MLB",
                "currency": "BRL",
                "currencyIcon": "R$",
                "imgUrl": "https://img.example.com/1.jpg",
                "variantAttribute": "红色/XL",
                "available": 50,
                "price": 199.90,
                "logisticType": "fulfillment",
                "productType": "normal",
                "url": "https://www.mercadolivre.com/item001",
                "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": 35
}