轻易云
注册体验

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

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

美客多广告 - 查询店铺报告列表

POST/basicOpen/mercadoAd/store/report/list
加工厂
{
  "operation": {
    "method": "POST",
    "path": "/basicOpen/mercadoAd/store/report/list"
  },
  "protocol": "HTTPS",
  "host": "https://openapi.lingxing.com",
  "rateLimit": {
    "tokenBucketCapacity": 1,
    "text": ""
  },
  "requestExample": "curl --location 'https://openapi.lingxing.com/basicOpen/mercadoAd/store/report/list?access_token=value&timestamp=value&sign=value&app_key=value' \\\n--header 'Content-Type: application/json' \\\n--data '{\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": "海外仓",
          "statusCode": 1,
          "statusDisplayName": "已启用",
          "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
  }
}

接口请求参数

序号字段名称类型默认值必填描述
1searchText搜索文本(按店铺名称模糊搜索)string—可选搜索文本(按店铺名称模糊搜索)
2requestFilter筛选字段object—可选筛选字段
2.1spend花费array<any>—可选花费
2.2cpacpaarray<any>—可选CPA
2.3directUnitsSold广告直接成交销量array<any>—可选广告直接成交销量
2.4indirectUnitsSold广告间接成交销量array<any>—可选广告间接成交销量
2.5impressions曝光量array<any>—可选曝光量
2.6clicks点击量array<any>—可选点击量
2.7ctrctrarray<any>—可选CTR
2.8cpccpcarray<any>—可选CPC
2.9totalUnitsSold店铺销量array<any>—可选店铺销量
2.10organicUnitsSold自然销量array<any>—可选自然销量
2.11adUnitsSold广告销量array<any>—可选广告销量
2.12totalSales店铺销售额array<any>—可选店铺销售额
2.13organicSales自然销售额array<any>—可选自然销售额
2.14adSales广告销售额array<any>—可选广告销售额
2.15adUnitPrice广告笔单价array<any>—可选广告笔单价
2.16directSales广告直接成交销售额array<any>—可选广告直接成交销售额
2.17indirectSales广告间接成交销售额array<any>—可选广告间接成交销售额
2.18racosracosarray<any>—可选RACoS
2.19roasroasarray<any>—可选ROAS
2.20tacostacosarray<any>—可选TACoS
2.21totalItemsSold店铺销售产品数array<any>—可选店铺销售产品数
2.22organicItemsSold自然销售产品数array<any>—可选自然销售产品数
2.23adItemsSold广告销售产品数array<any>—可选广告销售产品数
2.24sovsovarray<any>—可选SOV
3page当前页码integer—可选当前页码,默认1,最小1
4length每页大小integer—可选每页大小,默认20,最小1,最大200
5orderField排序字段(区分大小写)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-排名不足损失曝光占比 未传时按广告账号ID降序;指定排序字段时追加该ID降序。
6orderType排序方式string—可选排序方式:ASC-升序、DESC-降序;不区分大小写,指定排序字段时默认ASC
7summaryCurrencyCode报表币种编码string—可选报表币种编码,店铺、活动、广告组、广告商品列表传空时明细使用店铺币种、汇总使用USD项目币种枚举:ARS、BOB、BRL、CLP、CNY、COP、CRC、CUP、DOP、EUR、GTQ、HNL、MXN、NIO、PAB、PEN、PYG、USD、UYU、VES。
8startDate开始日期string—必填开始日期,格式:yyyy-MM-dd
9endDate结束日期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.7statusCode状态编码integer1必填状态编码,取值:1-已启用、0-已暂停
6.1.8statusDisplayName状态显示名称string已启用必填状态显示名称,statusCode=1 时默认为“已启用”、statusCode=0 时默认为“已暂停”,实际文案随语言变化。
6.1.9impressions曝光量string0必填曝光量
6.1.10clicks点击量string0必填点击量
6.1.11spend花费string0必填花费
6.1.12organicUnitsSold自然销量string0必填自然销量
6.1.13adUnitsSold广告销量string0必填广告销量
6.1.14directUnitsSold广告直接成交销量string0必填广告直接成交销量
6.1.15indirectUnitsSold广告间接成交销量string0必填广告间接成交销量
6.1.16organicSales自然销售额string0必填自然销售额
6.1.17adSales广告销售额string0必填广告销售额
6.1.18directSales广告直接成交销售额string0必填广告直接成交销售额
6.1.19indirectSales广告间接成交销售额string0必填广告间接成交销售额
6.1.20organicItemsSold自然销售产品数string0必填自然销售产品数
6.1.21adItemsSold广告销售产品数string0必填广告销售产品数
6.1.22directItemsSold广告直接销售产品数string0必填广告直接销售产品数
6.1.23indirectItemsSold广告间接销售产品数string0必填广告间接销售产品数
6.1.24adOrders广告订单string0必填广告订单
6.1.25totalUnitsSold店铺销量string0必填店铺销量
6.1.26totalSales店铺销售额string0必填店铺销售额
6.1.27totalItemsSold店铺销售产品数string0必填店铺销售产品数
6.1.28impressionsShare曝光率string0必填曝光率
6.1.29searchPositionTopImpressionsShare搜索结果首页曝光率string0必填搜索结果首页曝光率
6.1.30lostImpressionsShareBudgetShortfall预算不足损失曝光占比string0必填预算不足损失曝光占比
6.1.31lostImpressionsShareRankShortfall排名不足损失曝光占比string0必填排名不足损失曝光占比
6.1.32ctrctrstring0必填CTR
6.1.33cpccpcstring0必填CPC
6.1.34cvrcvrstring0必填CVR
6.1.35cpacpastring0必填CPA
6.1.36adUnitsSoldShare广告销量占比string0必填广告销量占比
6.1.37sovsovstring0必填sov
6.1.38adUnitPrice广告笔单价string0必填广告笔单价
6.1.39racosracosstring0必填RACoS
6.1.40roasroasstring0必填ROAS
6.1.41tacostacosstring0必填TACoS
6.1.42impressionsPercent曝光量百分比string0必填曝光量百分比
6.1.43clicksPercent点击量百分比string0必填点击量百分比
6.1.44spendPercent花费百分比string0必填花费百分比
6.1.45adOrdersPercent广告订单百分比string0必填广告订单百分比
6.1.46organicUnitsSoldPercent自然销量百分比string0必填自然销量百分比
6.1.47adUnitsSoldPercent广告销量百分比string0必填广告销量百分比
6.1.48organicSalesPercent自然销售额百分比string0必填自然销售额百分比
6.1.49adSalesPercent广告销售额百分比string0必填广告销售额百分比
6.1.50currencyCode币种编码项目币种枚举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/store/report/list),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。

需要对接这个接口?

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