Qeasy Cloud
Get Started

领星ERP 查询Mercado在线商品 API

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

查询Mercado在线商品

POST/basicOpen/multiplatform/mercado/list
Factory
{
  "operation": {
    "method": "POST",
    "path": "/basicOpen/multiplatform/mercado/list"
  },
  "protocol": "HTTPS",
  "host": "https://openapi.lingxing.com",
  "rateLimit": {
    "tokenBucketCapacity": 1,
    "text": ""
  },
  "requestExample": "curl --location 'https://openapi.lingxing.com/basicOpen/multiplatform/mercado/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    \"productType\": 1,\n    \"searchField\": 6,\n    \"searchSingleValue\": \"商品A\"\n}'",
  "responseExample": {
    "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.9,
          "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
  }
}

Request Parameters

No.FieldNameTypeDefaultRequiredDescription
1principalUids负责人用户ID列表array<any>—Optional负责人用户ID列表;传[-1]表示仅查询未分配负责人,-1不能与其他UID混传
2offset偏移量integer—Optional偏移量,默认0
3length每页条数integer—Optional每页条数,默认20,最大200
4storeIds店铺ID列表array<any>—Optional店铺ID列表
5pairingStatus配对状态integer—Optional配对状态 0=未配对 1=已配对
6searchSingleValue模糊搜索值string—Optional模糊搜索值
7searchValues精确搜索值列表array<any>—Optional精确搜索值列表
8searchField搜索字段integer—Optional搜索字段: 1=商品ID 2=标题 3=变体ID 4=父体 5=Family Name 6=MSKU 7=SKU 8=品名
9sortType排序方式string—Optional排序方式:asc/desc
10sortField排序字段string—Optional排序字段
11categoryIds分类ID列表array<any>—Optional分类ID列表
12brandIds品牌ID列表array<any>—Optional品牌ID列表
13productType商品类型integer—Required商品类型
14siteIdList站点ID列表array<any>—Optional站点ID列表
15statusList状态列表array<any>—Optional状态列表
16logisticTypeList物流类型列表array<any>—Optional物流类型列表
17timeType时间筛选类型integer—Optional时间筛选类型
18start开始时间(yyyy-MM-dd)string—Optional开始时间(yyyy-MM-dd)
19end结束时间(yyyy-MM-dd)string—Optional结束时间(yyyy-MM-dd)
20price金额筛选值number—Optional金额筛选值
21priceCondition金额筛选条件integer—Optional金额筛选条件: 1=大于 2=小于
22quantity库存数筛选值integer—Optional库存数筛选值
23quantityCondition库存筛选条件integer—Optional库存筛选条件: 1=大于 2=小于

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总数integer35Required总数
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商品IDstringITEM001Required商品ID
6.2.10variationId变体IDstringVAR001Required变体ID
6.2.11familyNameFamily NamestringFamily-ARequiredFamily Name
6.2.12mskuIdMSKU IDstringMSKU001RequiredMSKU ID
6.2.13mskumskustringmsku-testRequiredMSKU
6.2.14title标题string示例商品标题Required标题
6.2.15status状态stringactiveRequired状态
6.2.16statusName状态名称string在售Required状态名称
6.2.17siteName站点名称stringBrazilRequired站点名称
6.2.18siteCode站点编码stringMLBRequired站点编码
6.2.19currency币种stringBRLRequired币种
6.2.20currencyIcon币种符号stringR$Required币种符号
6.2.21imgUrl图片URLstringhttps://img.example.com/1.jpgRequired图片URL
6.2.22variantAttribute变体属性string红色/XLRequired变体属性
6.2.23available可用库存integer50Required可用库存
6.2.24price价格number199.9Required价格
6.2.25logisticType物流类型stringfulfillmentRequired物流类型
6.2.26productType商品类型stringnormalRequired商品类型
6.2.27url商品链接stringhttps://www.mercadolivre.com/item001Required商品链接
6.2.28createTime创建时间string2026-01-01 10:00:00Required创建时间
6.2.29updateTime更新时间string2026-01-05 10:00:00Required更新时间
6.2.30storeId店铺IDinteger1Required店铺ID
6.2.31storeName店铺名称string我的店铺Required店铺名称
6.2.32pname品名string商品ARequired品名
6.2.33skuskustringSKU001RequiredSKU
6.2.34pid本地产品IDinteger1001Required本地产品ID
6.2.35children子变体列表array<any>—Required子变体列表
7total总数integer35Required总数

The 查询Mercado在线商品 API (/basicOpen/multiplatform/mercado/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.