/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
}
}| No. | Field | Name | Type | Default | Required | Description |
|---|---|---|---|---|---|---|
| 1 | searchText | 搜索文本(按店铺名称模糊搜索) | string | — | Optional | 搜索文本(按店铺名称模糊搜索) |
| 2 | requestFilter | 筛选字段 | object | — | Optional | 筛选字段 |
| 2.1 | spend | 花费 | array<any> | — | Optional | 花费 |
| 2.2 | cpa | cpa | array<any> | — | Optional | CPA |
| 2.3 | directUnitsSold | 广告直接成交销量 | array<any> | — | Optional | 广告直接成交销量 |
| 2.4 | indirectUnitsSold | 广告间接成交销量 | array<any> | — | Optional | 广告间接成交销量 |
| 2.5 | impressions | 曝光量 | array<any> | — | Optional | 曝光量 |
| 2.6 | clicks | 点击量 | array<any> | — | Optional | 点击量 |
| 2.7 | ctr | ctr | array<any> | — | Optional | CTR |
| 2.8 | cpc | cpc | array<any> | — | Optional | CPC |
| 2.9 | totalUnitsSold | 店铺销量 | array<any> | — | Optional | 店铺销量 |
| 2.10 | organicUnitsSold | 自然销量 | array<any> | — | Optional | 自然销量 |
| 2.11 | adUnitsSold | 广告销量 | array<any> | — | Optional | 广告销量 |
| 2.12 | totalSales | 店铺销售额 | array<any> | — | Optional | 店铺销售额 |
| 2.13 | organicSales | 自然销售额 | array<any> | — | Optional | 自然销售额 |
| 2.14 | adSales | 广告销售额 | array<any> | — | Optional | 广告销售额 |
| 2.15 | adUnitPrice | 广告笔单价 | array<any> | — | Optional | 广告笔单价 |
| 2.16 | directSales | 广告直接成交销售额 | array<any> | — | Optional | 广告直接成交销售额 |
| 2.17 | indirectSales | 广告间接成交销售额 | array<any> | — | Optional | 广告间接成交销售额 |
| 2.18 | racos | racos | array<any> | — | Optional | RACoS |
| 2.19 | roas | roas | array<any> | — | Optional | ROAS |
| 2.20 | tacos | tacos | array<any> | — | Optional | TACoS |
| 2.21 | totalItemsSold | 店铺销售产品数 | array<any> | — | Optional | 店铺销售产品数 |
| 2.22 | organicItemsSold | 自然销售产品数 | array<any> | — | Optional | 自然销售产品数 |
| 2.23 | adItemsSold | 广告销售产品数 | array<any> | — | Optional | 广告销售产品数 |
| 2.24 | sov | sov | array<any> | — | Optional | SOV |
| 3 | page | 当前页码 | integer | — | Optional | 当前页码,默认1,最小1 |
| 4 | length | 每页大小 | integer | — | Optional | 每页大小,默认20,最小1,最大200 |
| 5 | orderField | 排序字段(区分大小写) | 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-排名不足损失曝光占比 未传时按广告账号ID降序;指定排序字段时追加该ID降序。 |
| 6 | orderType | 排序方式 | string | — | Optional | 排序方式:ASC-升序、DESC-降序;不区分大小写,指定排序字段时默认ASC |
| 7 | summaryCurrencyCode | 报表币种编码 | string | — | Optional | 报表币种编码,店铺、活动、广告组、广告商品列表传空时明细使用店铺币种、汇总使用USD项目币种枚举:ARS、BOB、BRL、CLP、CNY、COP、CRC、CUP、DOP、EUR、GTQ、HNL、MXN、NIO、PAB、PEN、PYG、USD、UYU、VES。 |
| 8 | startDate | 开始日期 | string | — | Required | 开始日期,格式:yyyy-MM-dd |
| 9 | endDate | 结束日期 | string | — | Required | 结束日期,格式:yyyy-MM-dd |
| No. | Field | Name | Type | Default | Required | Description |
|---|---|---|---|---|---|---|
| 1 | code | 状态码 | integer | 0 | Required | 状态码,0:成功 |
| 2 | message | 消息提示 | string | success | Required | 消息提示 |
| 3 | error_details | 数据校验失败时的错误详情 | array<any> | [] | Required | 数据校验失败时的错误详情 |
| 4 | request_id | 请求链路id | string | a0d54debf93140f3b58d1ed81e8e3583 | Required | 请求链路id |
| 5 | response_time | 响应时间 | string | 2026-09-20 12:00:00 | Required | 响应时间 |
| 6 | data | 响应数据 | object | — | Required | 响应数据 |
| 6.1 | list | 列表 | array<object> | — | Required | 列表 |
| 6.1.1 | advertiserId | 广告主账号ID | string | 123456 | Required | 广告主账号ID |
| 6.1.2 | advertiserName | 广告主账号名称 | string | 墨西哥广告账号 | Required | 广告主账号名称 |
| 6.1.3 | storeId | 店铺ID | string | 12345 | Required | 店铺ID |
| 6.1.4 | siteId | 站点ID项目站点枚举 | string | MLM | Required | 站点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 | 墨西哥店铺 | Required | 店铺名称 |
| 6.1.6 | mode | 海外仓/自发货 | string | 海外仓 | Required | 海外仓/自发货,取值:海外仓、自发货;未识别配送模式时为 null。 |
| 6.1.7 | statusCode | 状态编码 | integer | 1 | Required | 状态编码,取值:1-已启用、0-已暂停 |
| 6.1.8 | statusDisplayName | 状态显示名称 | string | 已启用 | Required | 状态显示名称,statusCode=1 时默认为“已启用”、statusCode=0 时默认为“已暂停”,实际文案随语言变化。 |
| 6.1.9 | impressions | 曝光量 | string | 0 | Required | 曝光量 |
| 6.1.10 | clicks | 点击量 | string | 0 | Required | 点击量 |
| 6.1.11 | spend | 花费 | string | 0 | Required | 花费 |
| 6.1.12 | organicUnitsSold | 自然销量 | string | 0 | Required | 自然销量 |
| 6.1.13 | adUnitsSold | 广告销量 | string | 0 | Required | 广告销量 |
| 6.1.14 | directUnitsSold | 广告直接成交销量 | string | 0 | Required | 广告直接成交销量 |
| 6.1.15 | indirectUnitsSold | 广告间接成交销量 | string | 0 | Required | 广告间接成交销量 |
| 6.1.16 | organicSales | 自然销售额 | string | 0 | Required | 自然销售额 |
| 6.1.17 | adSales | 广告销售额 | string | 0 | Required | 广告销售额 |
| 6.1.18 | directSales | 广告直接成交销售额 | string | 0 | Required | 广告直接成交销售额 |
| 6.1.19 | indirectSales | 广告间接成交销售额 | string | 0 | Required | 广告间接成交销售额 |
| 6.1.20 | organicItemsSold | 自然销售产品数 | string | 0 | Required | 自然销售产品数 |
| 6.1.21 | adItemsSold | 广告销售产品数 | string | 0 | Required | 广告销售产品数 |
| 6.1.22 | directItemsSold | 广告直接销售产品数 | string | 0 | Required | 广告直接销售产品数 |
| 6.1.23 | indirectItemsSold | 广告间接销售产品数 | string | 0 | Required | 广告间接销售产品数 |
| 6.1.24 | adOrders | 广告订单 | string | 0 | Required | 广告订单 |
| 6.1.25 | totalUnitsSold | 店铺销量 | string | 0 | Required | 店铺销量 |
| 6.1.26 | totalSales | 店铺销售额 | string | 0 | Required | 店铺销售额 |
| 6.1.27 | totalItemsSold | 店铺销售产品数 | string | 0 | Required | 店铺销售产品数 |
| 6.1.28 | impressionsShare | 曝光率 | string | 0 | Required | 曝光率 |
| 6.1.29 | searchPositionTopImpressionsShare | 搜索结果首页曝光率 | string | 0 | Required | 搜索结果首页曝光率 |
| 6.1.30 | lostImpressionsShareBudgetShortfall | 预算不足损失曝光占比 | string | 0 | Required | 预算不足损失曝光占比 |
| 6.1.31 | lostImpressionsShareRankShortfall | 排名不足损失曝光占比 | string | 0 | Required | 排名不足损失曝光占比 |
| 6.1.32 | ctr | ctr | string | 0 | Required | CTR |
| 6.1.33 | cpc | cpc | string | 0 | Required | CPC |
| 6.1.34 | cvr | cvr | string | 0 | Required | CVR |
| 6.1.35 | cpa | cpa | string | 0 | Required | CPA |
| 6.1.36 | adUnitsSoldShare | 广告销量占比 | string | 0 | Required | 广告销量占比 |
| 6.1.37 | sov | sov | string | 0 | Required | sov |
| 6.1.38 | adUnitPrice | 广告笔单价 | string | 0 | Required | 广告笔单价 |
| 6.1.39 | racos | racos | string | 0 | Required | RACoS |
| 6.1.40 | roas | roas | string | 0 | Required | ROAS |
| 6.1.41 | tacos | tacos | string | 0 | Required | TACoS |
| 6.1.42 | impressionsPercent | 曝光量百分比 | string | 0 | Required | 曝光量百分比 |
| 6.1.43 | clicksPercent | 点击量百分比 | string | 0 | Required | 点击量百分比 |
| 6.1.44 | spendPercent | 花费百分比 | string | 0 | Required | 花费百分比 |
| 6.1.45 | adOrdersPercent | 广告订单百分比 | string | 0 | Required | 广告订单百分比 |
| 6.1.46 | organicUnitsSoldPercent | 自然销量百分比 | string | 0 | Required | 自然销量百分比 |
| 6.1.47 | adUnitsSoldPercent | 广告销量百分比 | string | 0 | Required | 广告销量百分比 |
| 6.1.48 | organicSalesPercent | 自然销售额百分比 | string | 0 | Required | 自然销售额百分比 |
| 6.1.49 | adSalesPercent | 广告销售额百分比 | string | 0 | Required | 广告销售额百分比 |
| 6.1.50 | currencyCode | 币种编码项目币种枚举 | string | USD | Required | 币种编码项目币种枚举: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 | Required | 总数 |
| 7 | total | 总数 | integer | 1 | Required | 总数,与data.total一致 |
The 美客多广告 - 查询店铺报告列表 API (/basicOpen/mercadoAd/store/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.
Qeasy ships with prebuilt adaptation for this API — contact us to start configuring data integration.