轻易云
注册体验

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

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

美客多广告 - 查询活动报告列表

POST/basicOpen/mercadoAd/campaign/report/list
加工厂
{
  "operation": {
    "method": "POST",
    "path": "/basicOpen/mercadoAd/campaign/report/list"
  },
  "protocol": "HTTPS",
  "host": "https://openapi.lingxing.com",
  "rateLimit": {
    "tokenBucketCapacity": 1,
    "text": ""
  },
  "requestExample": "curl --location 'https://openapi.lingxing.com/basicOpen/mercadoAd/campaign/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    \"adItemIds\": [\n        \"MLM1234567890\"\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": "秋季广告活动",
          "statusCode": "active",
          "statusDisplayName": "已启用",
          "targetAcos": "0",
          "targetRoas": "0",
          "dailyBudget": "0",
          "storeCurrencyCode": "MXN",
          "adItems": [
            {
              "itemId": "MLM1234567890",
              "title": "运动鞋",
              "price": "0",
              "stock": "0",
              "imageUrl": "https://example.com/product.jpg"
            }
          ],
          "quantity": 1,
          "availableQuantity": 1,
          "impressions": "0",
          "clicks": "0",
          "spend": "0",
          "organicUnitsSold": "0",
          "adUnitsSold": "0",
          "directUnitsSold": "0",
          "indirectUnitsSold": "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",
          "impressionsShare": "0",
          "searchPositionTopImpressionsShare": "0",
          "lostImpressionsShareBudgetShortfall": "0",
          "lostImpressionsShareRankShortfall": "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-已暂停
2channelCodes渠道编码array<any>—可选渠道编码,取值:marketplace
3advertiserIds广告账号IDarray<any>—可选广告账号ID
4adItemIds广告商品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-广告销量占比 directUnitsSold-广告直接成交销量 indirectUnitsSold-广告间接成交销量 totalSales-店铺销售额 organicSales-自然销售额 organicSalesPercent-自然销售额百分比 adSales-广告销售额 adSalesPercent-广告销售额百分比 sov-sov adUnitPrice-广告笔单价 directSales-广告直接成交销售额 indirectSales-广告间接成交销售额 racos-RACoS roas-ROAS tacos-TACoS totalItemsSold-店铺销售产品数 organicItemsSold-自然销售产品数 adItemsSold-广告销售产品数 directItemsSold-广告直接销售产品数 indirectItemsSold-广告间接销售产品数 impressionsShare-曝光率 searchPositionTopImpressionsShare-搜索结果首页曝光率 lostImpressionsShareBudgetShortfall-预算不足损失曝光占比 lostImpressionsShareRankShortfall-排名不足损失曝光占比 targetRoas-目标ROAS dailyBudget-每日预算 targetAcos-目标ACoS 未传时按广告活动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.9statusCode状态编码stringactive必填状态编码,取值:active-已启用 paused-已暂停
6.1.10statusDisplayName状态显示名称string已启用必填状态显示名称,statusCode=active 时默认为“已启用”、statusCode=paused 时默认为“已暂停”,实际文案随语言变化。
6.1.11targetAcos目标ACoSstring0必填目标ACoS
6.1.12targetRoas目标ROASstring0必填目标ROAS
6.1.13dailyBudget每日预算string0必填每日预算
6.1.14storeCurrencyCode店铺币种stringMXN必填店铺币种,每日预算始终使用该币种项目币种枚举:ARS、BOB、BRL、CLP、CNY、COP、CRC、CUP、DOP、EUR、GTQ、HNL、MXN、NIO、PAB、PEN、PYG、USD、UYU、VES。
6.1.15adItems广告商品array<object>—必填广告商品
6.1.15.1itemIditemIdstringMLM1234567890必填itemId
6.1.15.2title标题string运动鞋必填标题
6.1.15.3price价格string0必填价格
6.1.15.4stock库存string0必填库存
6.1.15.5imageUrl图片URLstringhttps://example.com/product.jpg必填图片URL
6.1.16quantity总库存integer1必填总库存
6.1.17availableQuantity可用库存integer1必填可用库存
6.1.18impressions曝光量string0必填曝光量
6.1.19clicks点击量string0必填点击量
6.1.20spend花费string0必填花费
6.1.21organicUnitsSold自然销量string0必填自然销量
6.1.22adUnitsSold广告销量string0必填广告销量
6.1.23directUnitsSold广告直接成交销量string0必填广告直接成交销量
6.1.24indirectUnitsSold广告间接成交销量string0必填广告间接成交销量
6.1.25organicSales自然销售额string0必填自然销售额
6.1.26adSales广告销售额string0必填广告销售额
6.1.27directSales广告直接成交销售额string0必填广告直接成交销售额
6.1.28indirectSales广告间接成交销售额string0必填广告间接成交销售额
6.1.29organicItemsSold自然销售产品数string0必填自然销售产品数
6.1.30adItemsSold广告销售产品数string0必填广告销售产品数
6.1.31directItemsSold广告直接销售产品数string0必填广告直接销售产品数
6.1.32indirectItemsSold广告间接销售产品数string0必填广告间接销售产品数
6.1.33adOrders广告订单string0必填广告订单
6.1.34totalUnitsSold店铺销量string0必填店铺销量
6.1.35totalSales店铺销售额string0必填店铺销售额
6.1.36totalItemsSold店铺销售产品数string0必填店铺销售产品数
6.1.37impressionsShare曝光率string0必填曝光率
6.1.38searchPositionTopImpressionsShare搜索结果首页曝光率string0必填搜索结果首页曝光率
6.1.39lostImpressionsShareBudgetShortfall预算不足损失曝光占比string0必填预算不足损失曝光占比
6.1.40lostImpressionsShareRankShortfall排名不足损失曝光占比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/campaign/report/list),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。

需要对接这个接口?

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