/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×tamp=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
}
}| 序号 | 字段 | 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| 1 | searchText | 搜索文本(按店铺名称模糊搜索) | string | — | 可选 | 搜索文本(按店铺名称模糊搜索) |
| 2 | requestFilter | 筛选字段 | object | — | 可选 | 筛选字段 |
| 2.1 | spend | 花费 | array<any> | — | 可选 | 花费 |
| 2.2 | cpa | cpa | array<any> | — | 可选 | CPA |
| 2.3 | directUnitsSold | 广告直接成交销量 | array<any> | — | 可选 | 广告直接成交销量 |
| 2.4 | indirectUnitsSold | 广告间接成交销量 | array<any> | — | 可选 | 广告间接成交销量 |
| 2.5 | impressions | 曝光量 | array<any> | — | 可选 | 曝光量 |
| 2.6 | clicks | 点击量 | array<any> | — | 可选 | 点击量 |
| 2.7 | ctr | ctr | array<any> | — | 可选 | CTR |
| 2.8 | cpc | cpc | array<any> | — | 可选 | CPC |
| 2.9 | totalUnitsSold | 店铺销量 | array<any> | — | 可选 | 店铺销量 |
| 2.10 | organicUnitsSold | 自然销量 | array<any> | — | 可选 | 自然销量 |
| 2.11 | adUnitsSold | 广告销量 | array<any> | — | 可选 | 广告销量 |
| 2.12 | totalSales | 店铺销售额 | array<any> | — | 可选 | 店铺销售额 |
| 2.13 | organicSales | 自然销售额 | array<any> | — | 可选 | 自然销售额 |
| 2.14 | adSales | 广告销售额 | array<any> | — | 可选 | 广告销售额 |
| 2.15 | adUnitPrice | 广告笔单价 | array<any> | — | 可选 | 广告笔单价 |
| 2.16 | directSales | 广告直接成交销售额 | array<any> | — | 可选 | 广告直接成交销售额 |
| 2.17 | indirectSales | 广告间接成交销售额 | array<any> | — | 可选 | 广告间接成交销售额 |
| 2.18 | racos | racos | array<any> | — | 可选 | RACoS |
| 2.19 | roas | roas | array<any> | — | 可选 | ROAS |
| 2.20 | tacos | tacos | array<any> | — | 可选 | TACoS |
| 2.21 | totalItemsSold | 店铺销售产品数 | array<any> | — | 可选 | 店铺销售产品数 |
| 2.22 | organicItemsSold | 自然销售产品数 | array<any> | — | 可选 | 自然销售产品数 |
| 2.23 | adItemsSold | 广告销售产品数 | array<any> | — | 可选 | 广告销售产品数 |
| 2.24 | sov | sov | array<any> | — | 可选 | SOV |
| 3 | page | 当前页码 | integer | — | 可选 | 当前页码,默认1,最小1 |
| 4 | length | 每页大小 | integer | — | 可选 | 每页大小,默认20,最小1,最大200 |
| 5 | orderField | 排序字段(区分大小写) | 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降序。 |
| 6 | orderType | 排序方式 | string | — | 可选 | 排序方式:ASC-升序、DESC-降序;不区分大小写,指定排序字段时默认ASC |
| 7 | summaryCurrencyCode | 报表币种编码 | string | — | 可选 | 报表币种编码,店铺、活动、广告组、广告商品列表传空时明细使用店铺币种、汇总使用USD项目币种枚举:ARS、BOB、BRL、CLP、CNY、COP、CRC、CUP、DOP、EUR、GTQ、HNL、MXN、NIO、PAB、PEN、PYG、USD、UYU、VES。 |
| 8 | startDate | 开始日期 | string | — | 必填 | 开始日期,格式:yyyy-MM-dd |
| 9 | endDate | 结束日期 | string | — | 必填 | 结束日期,格式:yyyy-MM-dd |
| 序号 | 字段 | 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| 1 | code | 状态码 | integer | 0 | 必填 | 状态码,0:成功 |
| 2 | message | 消息提示 | string | success | 必填 | 消息提示 |
| 3 | error_details | 数据校验失败时的错误详情 | array<any> | [] | 必填 | 数据校验失败时的错误详情 |
| 4 | request_id | 请求链路id | string | a0d54debf93140f3b58d1ed81e8e3583 | 必填 | 请求链路id |
| 5 | response_time | 响应时间 | string | 2026-09-20 12:00:00 | 必填 | 响应时间 |
| 6 | data | 响应数据 | object | — | 必填 | 响应数据 |
| 6.1 | list | 列表 | array<object> | — | 必填 | 列表 |
| 6.1.1 | advertiserId | 广告主账号ID | string | 123456 | 必填 | 广告主账号ID |
| 6.1.2 | advertiserName | 广告主账号名称 | string | 墨西哥广告账号 | 必填 | 广告主账号名称 |
| 6.1.3 | storeId | 店铺ID | string | 12345 | 必填 | 店铺ID |
| 6.1.4 | siteId | 站点ID项目站点枚举 | string | MLM | 必填 | 站点ID项目站点枚举:CBT-跨境全局 MLA-阿根廷 MLB-巴西 MBO-玻利维亚 MLC-智利 MCO-哥伦比亚 MCR-哥斯达黎加 MCU-古巴 MRD-多米尼加共和国 MEC-厄瓜多尔 MSV-萨尔瓦多 MGT-危地马拉 MHN-洪都拉斯 MLM-墨西哥 MNI-尼加拉瓜 MPA-巴拿马 MPY-巴拉圭 MPE-秘鲁 MPT-葡萄牙 MLU-乌拉圭 MLV-委内瑞拉。 |
| 6.1.5 | storeName | 店铺名称 | string | 墨西哥店铺 | 必填 | 店铺名称 |
| 6.1.6 | mode | 海外仓/自发货 | string | 海外仓 | 必填 | 海外仓/自发货,取值:海外仓、自发货;未识别配送模式时为 null。 |
| 6.1.7 | statusCode | 状态编码 | integer | 1 | 必填 | 状态编码,取值:1-已启用、0-已暂停 |
| 6.1.8 | statusDisplayName | 状态显示名称 | string | 已启用 | 必填 | 状态显示名称,statusCode=1 时默认为“已启用”、statusCode=0 时默认为“已暂停”,实际文案随语言变化。 |
| 6.1.9 | impressions | 曝光量 | string | 0 | 必填 | 曝光量 |
| 6.1.10 | clicks | 点击量 | string | 0 | 必填 | 点击量 |
| 6.1.11 | spend | 花费 | string | 0 | 必填 | 花费 |
| 6.1.12 | organicUnitsSold | 自然销量 | string | 0 | 必填 | 自然销量 |
| 6.1.13 | adUnitsSold | 广告销量 | string | 0 | 必填 | 广告销量 |
| 6.1.14 | directUnitsSold | 广告直接成交销量 | string | 0 | 必填 | 广告直接成交销量 |
| 6.1.15 | indirectUnitsSold | 广告间接成交销量 | string | 0 | 必填 | 广告间接成交销量 |
| 6.1.16 | organicSales | 自然销售额 | string | 0 | 必填 | 自然销售额 |
| 6.1.17 | adSales | 广告销售额 | string | 0 | 必填 | 广告销售额 |
| 6.1.18 | directSales | 广告直接成交销售额 | string | 0 | 必填 | 广告直接成交销售额 |
| 6.1.19 | indirectSales | 广告间接成交销售额 | string | 0 | 必填 | 广告间接成交销售额 |
| 6.1.20 | organicItemsSold | 自然销售产品数 | string | 0 | 必填 | 自然销售产品数 |
| 6.1.21 | adItemsSold | 广告销售产品数 | string | 0 | 必填 | 广告销售产品数 |
| 6.1.22 | directItemsSold | 广告直接销售产品数 | string | 0 | 必填 | 广告直接销售产品数 |
| 6.1.23 | indirectItemsSold | 广告间接销售产品数 | string | 0 | 必填 | 广告间接销售产品数 |
| 6.1.24 | adOrders | 广告订单 | string | 0 | 必填 | 广告订单 |
| 6.1.25 | totalUnitsSold | 店铺销量 | string | 0 | 必填 | 店铺销量 |
| 6.1.26 | totalSales | 店铺销售额 | string | 0 | 必填 | 店铺销售额 |
| 6.1.27 | totalItemsSold | 店铺销售产品数 | string | 0 | 必填 | 店铺销售产品数 |
| 6.1.28 | impressionsShare | 曝光率 | string | 0 | 必填 | 曝光率 |
| 6.1.29 | searchPositionTopImpressionsShare | 搜索结果首页曝光率 | string | 0 | 必填 | 搜索结果首页曝光率 |
| 6.1.30 | lostImpressionsShareBudgetShortfall | 预算不足损失曝光占比 | string | 0 | 必填 | 预算不足损失曝光占比 |
| 6.1.31 | lostImpressionsShareRankShortfall | 排名不足损失曝光占比 | string | 0 | 必填 | 排名不足损失曝光占比 |
| 6.1.32 | ctr | ctr | string | 0 | 必填 | CTR |
| 6.1.33 | cpc | cpc | string | 0 | 必填 | CPC |
| 6.1.34 | cvr | cvr | string | 0 | 必填 | CVR |
| 6.1.35 | cpa | cpa | string | 0 | 必填 | CPA |
| 6.1.36 | adUnitsSoldShare | 广告销量占比 | string | 0 | 必填 | 广告销量占比 |
| 6.1.37 | sov | sov | string | 0 | 必填 | sov |
| 6.1.38 | adUnitPrice | 广告笔单价 | string | 0 | 必填 | 广告笔单价 |
| 6.1.39 | racos | racos | string | 0 | 必填 | RACoS |
| 6.1.40 | roas | roas | string | 0 | 必填 | ROAS |
| 6.1.41 | tacos | tacos | string | 0 | 必填 | TACoS |
| 6.1.42 | impressionsPercent | 曝光量百分比 | string | 0 | 必填 | 曝光量百分比 |
| 6.1.43 | clicksPercent | 点击量百分比 | string | 0 | 必填 | 点击量百分比 |
| 6.1.44 | spendPercent | 花费百分比 | string | 0 | 必填 | 花费百分比 |
| 6.1.45 | adOrdersPercent | 广告订单百分比 | string | 0 | 必填 | 广告订单百分比 |
| 6.1.46 | organicUnitsSoldPercent | 自然销量百分比 | string | 0 | 必填 | 自然销量百分比 |
| 6.1.47 | adUnitsSoldPercent | 广告销量百分比 | string | 0 | 必填 | 广告销量百分比 |
| 6.1.48 | organicSalesPercent | 自然销售额百分比 | string | 0 | 必填 | 自然销售额百分比 |
| 6.1.49 | adSalesPercent | 广告销售额百分比 | string | 0 | 必填 | 广告销售额百分比 |
| 6.1.50 | currencyCode | 币种编码项目币种枚举 | string | USD | 必填 | 币种编码项目币种枚举:ARS、BOB、BRL、CLP、CNY、COP、CRC、CUP、DOP、EUR、GTQ、HNL、MXN、NIO、PAB、PEN、PYG、USD、UYU、VES。 |
| 6.2 | total | 总数 | integer | 1 | 必填 | 总数 |
| 7 | total | 总数 | integer | 1 | 必填 | 总数,与data.total一致 |
领星ERP的接口:美客多广告 - 查询店铺报告列表(/basicOpen/mercadoAd/store/report/list),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。