Qeasy Cloud
Get Started

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

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

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

POST/basicOpen/mercadoAd/campaign/report/list
Factory
{
  "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
  }
}

Request Parameters

No.FieldNameTypeDefaultRequiredDescription
1statusCodes状态编码取值array<any>—Optional状态编码取值:active-已启用 paused-已暂停
2channelCodes渠道编码array<any>—Optional渠道编码,取值:marketplace
3advertiserIds广告账号IDarray<any>—Optional广告账号ID
4adItemIds广告商品IDarray<any>—Optional广告商品ID,传入非空集合时仅查询已启用的广告活动
5searchText搜索文本(按广告活动名称模糊搜索)string—Optional搜索文本(按广告活动名称模糊搜索)
6requestFilter筛选字段object—Optional筛选字段
6.1spend花费array<any>—Optional花费
6.2cpacpaarray<any>—OptionalCPA
6.3directUnitsSold广告直接成交销量array<any>—Optional广告直接成交销量
6.4indirectUnitsSold广告间接成交销量array<any>—Optional广告间接成交销量
6.5impressions曝光量array<any>—Optional曝光量
6.6clicks点击量array<any>—Optional点击量
6.7ctrctrarray<any>—OptionalCTR
6.8cpccpcarray<any>—OptionalCPC
6.9totalUnitsSold店铺销量array<any>—Optional店铺销量
6.10organicUnitsSold自然销量array<any>—Optional自然销量
6.11adUnitsSold广告销量array<any>—Optional广告销量
6.12totalSales店铺销售额array<any>—Optional店铺销售额
6.13organicSales自然销售额array<any>—Optional自然销售额
6.14adSales广告销售额array<any>—Optional广告销售额
6.15adUnitPrice广告笔单价array<any>—Optional广告笔单价
6.16directSales广告直接成交销售额array<any>—Optional广告直接成交销售额
6.17indirectSales广告间接成交销售额array<any>—Optional广告间接成交销售额
6.18racosracosarray<any>—OptionalRACoS
6.19roasroasarray<any>—OptionalROAS
6.20tacostacosarray<any>—OptionalTACoS
6.21totalItemsSold店铺销售产品数array<any>—Optional店铺销售产品数
6.22organicItemsSold自然销售产品数array<any>—Optional自然销售产品数
6.23adItemsSold广告销售产品数array<any>—Optional广告销售产品数
6.24sovsovarray<any>—OptionalSOV
7page当前页码integer—Optional当前页码,默认1,最小1
8length每页大小integer—Optional每页大小,默认20,最小1,最大200
9orderField排序字段(区分大小写)string—Optional排序字段(区分大小写):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—Optional排序方式:ASC-升序、DESC-降序;不区分大小写,指定排序字段时默认ASC
11summaryCurrencyCode报表币种编码string—Optional报表币种编码,店铺、活动、广告组、广告商品列表传空时明细使用店铺币种、汇总使用USD项目币种枚举:ARS、BOB、BRL、CLP、CNY、COP、CRC、CUP、DOP、EUR、GTQ、HNL、MXN、NIO、PAB、PEN、PYG、USD、UYU、VES。
12startDate开始日期string—Required开始日期,格式:yyyy-MM-dd
13endDate结束日期string—Required结束日期,格式:yyyy-MM-dd

Response Parameters

No.FieldNameTypeDefaultRequiredDescription
1code状态码integer0Required状态码,0:成功
2message消息提示stringsuccessRequired消息提示
3error_details数据校验失败时的错误详情array<any>[]Required数据校验失败时的错误详情
4request_id请求链路idstringa0d54debf93140f3b58d1ed81e8e3583Required请求链路id
5response_time响应时间string2026-09-20 12:00:00Required响应时间
6data响应数据object—Required响应数据
6.1list列表array<object>—Required列表
6.1.1advertiserId广告主账号IDstring123456Required广告主账号ID
6.1.2advertiserName广告主账号名称string墨西哥广告账号Required广告主账号名称
6.1.3storeId店铺IDstring12345Required店铺ID
6.1.4siteId站点ID项目站点枚举stringMLMRequired站点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墨西哥店铺Required店铺名称
6.1.6mode海外仓/自发货string海外仓Required海外仓/自发货,取值:海外仓、自发货;未识别配送模式时为 null。
6.1.7campaignId广告活动IDstring987654Required广告活动ID
6.1.8campaignName广告活动名称string秋季广告活动Required广告活动名称
6.1.9statusCode状态编码stringactiveRequired状态编码,取值:active-已启用 paused-已暂停
6.1.10statusDisplayName状态显示名称string已启用Required状态显示名称,statusCode=active 时默认为“已启用”、statusCode=paused 时默认为“已暂停”,实际文案随语言变化。
6.1.11targetAcos目标ACoSstring0Required目标ACoS
6.1.12targetRoas目标ROASstring0Required目标ROAS
6.1.13dailyBudget每日预算string0Required每日预算
6.1.14storeCurrencyCode店铺币种stringMXNRequired店铺币种,每日预算始终使用该币种项目币种枚举: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>—Required广告商品
6.1.15.1itemIditemIdstringMLM1234567890RequireditemId
6.1.15.2title标题string运动鞋Required标题
6.1.15.3price价格string0Required价格
6.1.15.4stock库存string0Required库存
6.1.15.5imageUrl图片URLstringhttps://example.com/product.jpgRequired图片URL
6.1.16quantity总库存integer1Required总库存
6.1.17availableQuantity可用库存integer1Required可用库存
6.1.18impressions曝光量string0Required曝光量
6.1.19clicks点击量string0Required点击量
6.1.20spend花费string0Required花费
6.1.21organicUnitsSold自然销量string0Required自然销量
6.1.22adUnitsSold广告销量string0Required广告销量
6.1.23directUnitsSold广告直接成交销量string0Required广告直接成交销量
6.1.24indirectUnitsSold广告间接成交销量string0Required广告间接成交销量
6.1.25organicSales自然销售额string0Required自然销售额
6.1.26adSales广告销售额string0Required广告销售额
6.1.27directSales广告直接成交销售额string0Required广告直接成交销售额
6.1.28indirectSales广告间接成交销售额string0Required广告间接成交销售额
6.1.29organicItemsSold自然销售产品数string0Required自然销售产品数
6.1.30adItemsSold广告销售产品数string0Required广告销售产品数
6.1.31directItemsSold广告直接销售产品数string0Required广告直接销售产品数
6.1.32indirectItemsSold广告间接销售产品数string0Required广告间接销售产品数
6.1.33adOrders广告订单string0Required广告订单
6.1.34totalUnitsSold店铺销量string0Required店铺销量
6.1.35totalSales店铺销售额string0Required店铺销售额
6.1.36totalItemsSold店铺销售产品数string0Required店铺销售产品数
6.1.37impressionsShare曝光率string0Required曝光率
6.1.38searchPositionTopImpressionsShare搜索结果首页曝光率string0Required搜索结果首页曝光率
6.1.39lostImpressionsShareBudgetShortfall预算不足损失曝光占比string0Required预算不足损失曝光占比
6.1.40lostImpressionsShareRankShortfall排名不足损失曝光占比string0Required排名不足损失曝光占比
6.1.41ctrctrstring0RequiredCTR
6.1.42cpccpcstring0RequiredCPC
6.1.43cvrcvrstring0RequiredCVR
6.1.44cpacpastring0RequiredCPA
6.1.45adUnitsSoldShare广告销量占比string0Required广告销量占比
6.1.46sovsovstring0Requiredsov
6.1.47adUnitPrice广告笔单价string0Required广告笔单价
6.1.48racosracosstring0RequiredRACoS
6.1.49roasroasstring0RequiredROAS
6.1.50tacostacosstring0RequiredTACoS
6.1.51impressionsPercent曝光量百分比string0Required曝光量百分比
6.1.52clicksPercent点击量百分比string0Required点击量百分比
6.1.53spendPercent花费百分比string0Required花费百分比
6.1.54adOrdersPercent广告订单百分比string0Required广告订单百分比
6.1.55organicUnitsSoldPercent自然销量百分比string0Required自然销量百分比
6.1.56adUnitsSoldPercent广告销量百分比string0Required广告销量百分比
6.1.57organicSalesPercent自然销售额百分比string0Required自然销售额百分比
6.1.58adSalesPercent广告销售额百分比string0Required广告销售额百分比
6.1.59currencyCode币种编码项目币种枚举stringUSDRequired币种编码项目币种枚举:ARS、BOB、BRL、CLP、CNY、COP、CRC、CUP、DOP、EUR、GTQ、HNL、MXN、NIO、PAB、PEN、PYG、USD、UYU、VES。
6.2total总数integer1Required总数
7total总数integer1Required总数,与data.total一致

The 美客多广告 - 查询活动报告列表 API (/basicOpen/mercadoAd/campaign/report/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.