轻易云
注册体验

领星ERP美客多广告 - 查询商品报告列表接口

所属平台
领星ERP
类型
WebAPI
作用
QUERY
接口版本
1.0
适配器
\Adapter\LingXing\LXQueryAdapter
授权方式
OTHER
描述
多平台 / 广告 / 美客多广告 · POST · 请求参数 37 个(必填 2) · 响应参数 72 个 · 限流令牌桶容量 1
更新日期
2026-11-21

美客多广告 - 查询商品报告列表

POST/basicOpen/mercadoAd/adItem/report/list
加工厂
{
  "operation": {
    "method": "POST",
    "path": "/basicOpen/mercadoAd/adItem/report/list"
  },
  "protocol": "HTTPS",
  "host": "https://openapi.lingxing.com",
  "rateLimit": {
    "tokenBucketCapacity": 1,
    "text": ""
  },
  "requestExample": "curl --location 'https://openapi.lingxing.com/basicOpen/mercadoAd/adItem/report/list?access_token=value&timestamp=value&sign=value&app_key=value' \\\n--header 'Content-Type: application/json' \\\n--data '{\n    \"statusCodes\": [\n        \"active\"\n    ],\n    \"channelCodes\": [\n        \"marketplace\"\n    ],\n    \"advertiserIds\": [\n        \"123456\"\n    ],\n    \"campaignIds\": [\n        \"987654\"\n    ],\n    \"page\": 1,\n    \"length\": 20,\n    \"orderField\": \"spend\",\n    \"orderType\": \"DESC\",\n    \"summaryCurrencyCode\": \"USD\",\n    \"startDate\": \"2026-09-01\",\n    \"endDate\": \"2026-09-15\"\n}'",
  "responseExample": {
    "code": 0,
    "message": "success",
    "error_details": [],
    "request_id": "a0d54debf93140f3b58d1ed81e8e3583",
    "response_time": "2026-09-20 12:00:00",
    "data": {
      "list": [
        {
          "advertiserId": "123456",
          "advertiserName": "墨西哥广告账号",
          "storeId": "12345",
          "siteId": "MLM",
          "storeName": "墨西哥店铺",
          "mode": "海外仓",
          "campaignId": "987654",
          "campaignName": "秋季广告活动",
          "campaignStatusCode": "active",
          "itemId": "MLM1234567890",
          "title": "运动鞋",
          "price": "0",
          "quantity": 1,
          "availableQuantity": 1,
          "variations": [
            {
              "variationId": "123456789",
              "sku": "SKU-001",
              "quantity": 1,
              "availableQuantity": 1
            }
          ],
          "imageUrl": "https://example.com/product.jpg",
          "statusCode": "active",
          "statusDisplayName": "已启用",
          "serviceStatus": "投放中",
          "buyBoxWinnerCode": 1,
          "includeVariant": 1,
          "discountStatusCode": 1,
          "permalink": "https://example.com/product",
          "impressions": "0",
          "clicks": "0",
          "spend": "0",
          "organicUnitsSold": "0",
          "adUnitsSold": "0",
          "organicSales": "0",
          "adSales": "0",
          "directSales": "0",
          "indirectSales": "0",
          "organicItemsSold": "0",
          "adItemsSold": "0",
          "directItemsSold": "0",
          "indirectItemsSold": "0",
          "adOrders": "0",
          "totalUnitsSold": "0",
          "totalSales": "0",
          "totalItemsSold": "0",
          "ctr": "0",
          "cpc": "0",
          "cvr": "0",
          "cpa": "0",
          "adUnitsSoldShare": "0",
          "sov": "0",
          "adUnitPrice": "0",
          "racos": "0",
          "roas": "0",
          "tacos": "0",
          "impressionsPercent": "0",
          "clicksPercent": "0",
          "spendPercent": "0",
          "adOrdersPercent": "0",
          "organicUnitsSoldPercent": "0",
          "adUnitsSoldPercent": "0",
          "organicSalesPercent": "0",
          "adSalesPercent": "0",
          "currencyCode": "USD"
        }
      ],
      "total": 1
    },
    "total": 1
  }
}

接口请求参数

序号字段名称类型默认值必填描述
1statusCodes状态编码取值array<any>—可选状态编码取值:active-已启用 paused-已暂停 hold-已下架 deleted-已归档
2channelCodes渠道编码array<any>—可选渠道编码,取值:marketplace
3advertiserIds广告账号IDarray<any>—可选广告账号ID
4campaignIds广告活动IDarray<any>—可选广告活动ID
5searchText搜索文本(按广告商品标题模糊搜索)string—可选搜索文本(按广告商品标题模糊搜索)
6requestFilter筛选字段object—可选筛选字段
6.1spend花费array<any>—可选花费
6.2cpacpaarray<any>—可选CPA
6.3directUnitsSold广告直接成交销量array<any>—可选广告直接成交销量
6.4indirectUnitsSold广告间接成交销量array<any>—可选广告间接成交销量
6.5impressions曝光量array<any>—可选曝光量
6.6clicks点击量array<any>—可选点击量
6.7ctrctrarray<any>—可选CTR
6.8cpccpcarray<any>—可选CPC
6.9totalUnitsSold店铺销量array<any>—可选店铺销量
6.10organicUnitsSold自然销量array<any>—可选自然销量
6.11adUnitsSold广告销量array<any>—可选广告销量
6.12totalSales店铺销售额array<any>—可选店铺销售额
6.13organicSales自然销售额array<any>—可选自然销售额
6.14adSales广告销售额array<any>—可选广告销售额
6.15adUnitPrice广告笔单价array<any>—可选广告笔单价
6.16directSales广告直接成交销售额array<any>—可选广告直接成交销售额
6.17indirectSales广告间接成交销售额array<any>—可选广告间接成交销售额
6.18racosracosarray<any>—可选RACoS
6.19roasroasarray<any>—可选ROAS
6.20tacostacosarray<any>—可选TACoS
6.21totalItemsSold店铺销售产品数array<any>—可选店铺销售产品数
6.22organicItemsSold自然销售产品数array<any>—可选自然销售产品数
6.23adItemsSold广告销售产品数array<any>—可选广告销售产品数
6.24sovsovarray<any>—可选SOV
7page当前页码integer—可选当前页码,默认1,最小1
8length每页大小integer—可选每页大小,默认20,最小1,最大200
9orderField排序字段(区分大小写)string—可选排序字段(区分大小写):impressions-曝光量 impressionsPercent-曝光量百分比 clicks-点击量 clicksPercent-点击量百分比 ctr-CTR cpc-CPC spend-花费 spendPercent-花费百分比 adOrders-广告订单 adOrdersPercent-广告订单百分比 cvr-CVR cpa-CPA totalUnitsSold-店铺销量 organicUnitsSold-自然销量 organicUnitsSoldPercent-自然销量百分比 adUnitsSold-广告销量 adUnitsSoldPercent-广告销量百分比 adUnitsSoldShare-广告销量占比 totalSales-店铺销售额 organicSales-自然销售额 organicSalesPercent-自然销售额百分比 adSales-广告销售额 adSalesPercent-广告销售额百分比 sov-sov adUnitPrice-广告笔单价 directSales-广告直接成交销售额 indirectSales-广告间接成交销售额 racos-RACoS roas-ROAS tacos-TACoS totalItemsSold-店铺销售产品数 organicItemsSold-自然销售产品数 adItemsSold-广告销售产品数 directItemsSold-广告直接销售产品数 indirectItemsSold-广告间接销售产品数 未传时按商品ID降序;指定排序字段时追加该ID降序。
10orderType排序方式string—可选排序方式:ASC-升序、DESC-降序;不区分大小写,指定排序字段时默认ASC
11summaryCurrencyCode报表币种编码string—可选报表币种编码,店铺、活动、广告组、广告商品列表传空时明细使用店铺币种、汇总使用USD项目币种枚举:ARS、BOB、BRL、CLP、CNY、COP、CRC、CUP、DOP、EUR、GTQ、HNL、MXN、NIO、PAB、PEN、PYG、USD、UYU、VES。
12startDate开始日期string—必填开始日期,格式:yyyy-MM-dd
13endDate结束日期string—必填结束日期,格式:yyyy-MM-dd

接口响应参数

序号字段名称类型默认值必填描述
1code状态码integer0必填状态码,0:成功
2message消息提示stringsuccess必填消息提示
3error_details数据校验失败时的错误详情array<any>[]必填数据校验失败时的错误详情
4request_id请求链路idstringa0d54debf93140f3b58d1ed81e8e3583必填请求链路id
5response_time响应时间string2026-09-20 12:00:00必填响应时间
6data响应数据object—必填响应数据
6.1list列表array<object>—必填列表
6.1.1advertiserId广告主账号IDstring123456必填广告主账号ID
6.1.2advertiserName广告主账号名称string墨西哥广告账号必填广告主账号名称
6.1.3storeId店铺IDstring12345必填店铺ID
6.1.4siteId站点ID项目站点枚举stringMLM必填站点ID项目站点枚举:CBT-跨境全局 MLA-阿根廷 MLB-巴西 MBO-玻利维亚 MLC-智利 MCO-哥伦比亚 MCR-哥斯达黎加 MCU-古巴 MRD-多米尼加共和国 MEC-厄瓜多尔 MSV-萨尔瓦多 MGT-危地马拉 MHN-洪都拉斯 MLM-墨西哥 MNI-尼加拉瓜 MPA-巴拿马 MPY-巴拉圭 MPE-秘鲁 MPT-葡萄牙 MLU-乌拉圭 MLV-委内瑞拉。
6.1.5storeName店铺名称string墨西哥店铺必填店铺名称
6.1.6mode海外仓/自发货string海外仓必填海外仓/自发货,取值:海外仓、自发货;未识别配送模式时为 null。
6.1.7campaignId广告活动IDstring987654必填广告活动ID
6.1.8campaignName广告活动名称string秋季广告活动必填广告活动名称
6.1.9campaignStatusCode广告活动状态编码stringactive必填广告活动状态编码,取值:active-已启用 paused-已暂停
6.1.10itemIditemIdstringMLM1234567890必填itemId
6.1.11title标题string运动鞋必填标题
6.1.12price价格string0必填价格
6.1.13quantity总库存integer1必填总库存
6.1.14availableQuantity可用库存integer1必填可用库存
6.1.15variations包含变体信息array<object>—必填包含变体信息
6.1.15.1variationId变体IDstring123456789必填变体ID
6.1.15.2skuskustringSKU-001必填SKU
6.1.15.3quantity总库存integer1必填总库存
6.1.15.4availableQuantity可用库存integer1必填可用库存
6.1.16imageUrl图片URLstringhttps://example.com/product.jpg必填图片URL
6.1.17statusCode状态编码stringactive必填状态编码,取值:active-已启用 paused-已暂停 hold-已下架 deleted-已归档
6.1.18statusDisplayName状态显示名称string已启用必填状态显示名称,默认文案:active-已启用 paused-已暂停 hold-已下架 deleted-已归档,实际文案随语言变化。
6.1.19serviceStatus投放服务状态文案string投放中必填投放服务状态文案,由原始状态映射,默认取值:投放中、已暂停、投放停止、闲置中、已下架、审核中。对应原始状态:A-投放中、P-已暂停、S-投放停止、I-闲置中、C-已下架、U-审核中;实际返回文案随语言变化,未识别时为 null。
6.1.20buyBoxWinnerCode赢得购物车编码integer1必填赢得购物车编码,取值:0-未赢得、1-已赢得
6.1.21includeVariant包含变体integer1必填包含变体,取值:0-不包含、1-包含;未获取到库存变体信息时为 null。
6.1.22discountStatusCode折扣状态integer1必填折扣状态,取值:1-折扣中、其他-无
6.1.23permalink永久项目链接stringhttps://example.com/product必填永久项目链接
6.1.24impressions曝光量string0必填曝光量
6.1.25clicks点击量string0必填点击量
6.1.26spend花费string0必填花费
6.1.27organicUnitsSold自然销量string0必填自然销量
6.1.28adUnitsSold广告销量string0必填广告销量
6.1.29organicSales自然销售额string0必填自然销售额
6.1.30adSales广告销售额string0必填广告销售额
6.1.31directSales广告直接成交销售额string0必填广告直接成交销售额
6.1.32indirectSales广告间接成交销售额string0必填广告间接成交销售额
6.1.33organicItemsSold自然销售产品数string0必填自然销售产品数
6.1.34adItemsSold广告销售产品数string0必填广告销售产品数
6.1.35directItemsSold广告直接销售产品数string0必填广告直接销售产品数
6.1.36indirectItemsSold广告间接销售产品数string0必填广告间接销售产品数
6.1.37adOrders广告订单string0必填广告订单
6.1.38totalUnitsSold店铺销量string0必填店铺销量
6.1.39totalSales店铺销售额string0必填店铺销售额
6.1.40totalItemsSold店铺销售产品数string0必填店铺销售产品数
6.1.41ctrctrstring0必填CTR
6.1.42cpccpcstring0必填CPC
6.1.43cvrcvrstring0必填CVR
6.1.44cpacpastring0必填CPA
6.1.45adUnitsSoldShare广告销量占比string0必填广告销量占比
6.1.46sovsovstring0必填sov
6.1.47adUnitPrice广告笔单价string0必填广告笔单价
6.1.48racosracosstring0必填RACoS
6.1.49roasroasstring0必填ROAS
6.1.50tacostacosstring0必填TACoS
6.1.51impressionsPercent曝光量百分比string0必填曝光量百分比
6.1.52clicksPercent点击量百分比string0必填点击量百分比
6.1.53spendPercent花费百分比string0必填花费百分比
6.1.54adOrdersPercent广告订单百分比string0必填广告订单百分比
6.1.55organicUnitsSoldPercent自然销量百分比string0必填自然销量百分比
6.1.56adUnitsSoldPercent广告销量百分比string0必填广告销量百分比
6.1.57organicSalesPercent自然销售额百分比string0必填自然销售额百分比
6.1.58adSalesPercent广告销售额百分比string0必填广告销售额百分比
6.1.59currencyCode币种编码项目币种枚举stringUSD必填币种编码项目币种枚举:ARS、BOB、BRL、CLP、CNY、COP、CRC、CUP、DOP、EUR、GTQ、HNL、MXN、NIO、PAB、PEN、PYG、USD、UYU、VES。
6.2total总数integer1必填总数
7total总数integer1必填总数,与data.total一致

领星ERP的接口:美客多广告 - 查询商品报告列表(/basicOpen/mercadoAd/adItem/report/list),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。

需要对接这个接口?

轻易云已预置该接口的适配能力,联系我们即可开始配置数据集成。