/basicOpen/mercadoAd/adItem/report/list{
"operation": {
"method": "POST",
"path": "/basicOpen/mercadoAd/adItem/report/list"
},
"protocol": "HTTPS",
"host": "https://openapi.lingxing.com",
"rateLimit": {
"tokenBucketCapacity": 1,
"text": ""
},
"requestExample": "curl --location 'https://openapi.lingxing.com/basicOpen/mercadoAd/adItem/report/list?access_token=value×tamp=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 \"campaignIds\": [\n \"987654\"\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": "秋季广告活动",
"campaignStatusCode": "active",
"itemId": "MLM1234567890",
"title": "运动鞋",
"price": "0",
"quantity": 1,
"availableQuantity": 1,
"variations": [
{
"variationId": "123456789",
"sku": "SKU-001",
"quantity": 1,
"availableQuantity": 1
}
],
"imageUrl": "https://example.com/product.jpg",
"statusCode": "active",
"statusDisplayName": "已启用",
"serviceStatus": "投放中",
"buyBoxWinnerCode": 1,
"includeVariant": 1,
"discountStatusCode": 1,
"permalink": "https://example.com/product",
"impressions": "0",
"clicks": "0",
"spend": "0",
"organicUnitsSold": "0",
"adUnitsSold": "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",
"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 | statusCodes | 状态编码取值 | array<any> | — | Optional | 状态编码取值:active-已启用 paused-已暂停 hold-已下架 deleted-已归档 |
| 2 | channelCodes | 渠道编码 | array<any> | — | Optional | 渠道编码,取值:marketplace |
| 3 | advertiserIds | 广告账号ID | array<any> | — | Optional | 广告账号ID |
| 4 | campaignIds | 广告活动ID | array<any> | — | Optional | 广告活动ID |
| 5 | searchText | 搜索文本(按广告商品标题模糊搜索) | string | — | Optional | 搜索文本(按广告商品标题模糊搜索) |
| 6 | requestFilter | 筛选字段 | object | — | Optional | 筛选字段 |
| 6.1 | spend | 花费 | array<any> | — | Optional | 花费 |
| 6.2 | cpa | cpa | array<any> | — | Optional | CPA |
| 6.3 | directUnitsSold | 广告直接成交销量 | array<any> | — | Optional | 广告直接成交销量 |
| 6.4 | indirectUnitsSold | 广告间接成交销量 | array<any> | — | Optional | 广告间接成交销量 |
| 6.5 | impressions | 曝光量 | array<any> | — | Optional | 曝光量 |
| 6.6 | clicks | 点击量 | array<any> | — | Optional | 点击量 |
| 6.7 | ctr | ctr | array<any> | — | Optional | CTR |
| 6.8 | cpc | cpc | array<any> | — | Optional | CPC |
| 6.9 | totalUnitsSold | 店铺销量 | array<any> | — | Optional | 店铺销量 |
| 6.10 | organicUnitsSold | 自然销量 | array<any> | — | Optional | 自然销量 |
| 6.11 | adUnitsSold | 广告销量 | array<any> | — | Optional | 广告销量 |
| 6.12 | totalSales | 店铺销售额 | array<any> | — | Optional | 店铺销售额 |
| 6.13 | organicSales | 自然销售额 | array<any> | — | Optional | 自然销售额 |
| 6.14 | adSales | 广告销售额 | array<any> | — | Optional | 广告销售额 |
| 6.15 | adUnitPrice | 广告笔单价 | array<any> | — | Optional | 广告笔单价 |
| 6.16 | directSales | 广告直接成交销售额 | array<any> | — | Optional | 广告直接成交销售额 |
| 6.17 | indirectSales | 广告间接成交销售额 | array<any> | — | Optional | 广告间接成交销售额 |
| 6.18 | racos | racos | array<any> | — | Optional | RACoS |
| 6.19 | roas | roas | array<any> | — | Optional | ROAS |
| 6.20 | tacos | tacos | array<any> | — | Optional | TACoS |
| 6.21 | totalItemsSold | 店铺销售产品数 | array<any> | — | Optional | 店铺销售产品数 |
| 6.22 | organicItemsSold | 自然销售产品数 | array<any> | — | Optional | 自然销售产品数 |
| 6.23 | adItemsSold | 广告销售产品数 | array<any> | — | Optional | 广告销售产品数 |
| 6.24 | sov | sov | array<any> | — | Optional | SOV |
| 7 | page | 当前页码 | integer | — | Optional | 当前页码,默认1,最小1 |
| 8 | length | 每页大小 | integer | — | Optional | 每页大小,默认20,最小1,最大200 |
| 9 | 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-广告销量占比 totalSales-店铺销售额 organicSales-自然销售额 organicSalesPercent-自然销售额百分比 adSales-广告销售额 adSalesPercent-广告销售额百分比 sov-sov adUnitPrice-广告笔单价 directSales-广告直接成交销售额 indirectSales-广告间接成交销售额 racos-RACoS roas-ROAS tacos-TACoS totalItemsSold-店铺销售产品数 organicItemsSold-自然销售产品数 adItemsSold-广告销售产品数 directItemsSold-广告直接销售产品数 indirectItemsSold-广告间接销售产品数 未传时按商品ID降序;指定排序字段时追加该ID降序。 |
| 10 | orderType | 排序方式 | string | — | Optional | 排序方式:ASC-升序、DESC-降序;不区分大小写,指定排序字段时默认ASC |
| 11 | summaryCurrencyCode | 报表币种编码 | string | — | Optional | 报表币种编码,店铺、活动、广告组、广告商品列表传空时明细使用店铺币种、汇总使用USD项目币种枚举:ARS、BOB、BRL、CLP、CNY、COP、CRC、CUP、DOP、EUR、GTQ、HNL、MXN、NIO、PAB、PEN、PYG、USD、UYU、VES。 |
| 12 | startDate | 开始日期 | string | — | Required | 开始日期,格式:yyyy-MM-dd |
| 13 | 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 | campaignId | 广告活动ID | string | 987654 | Required | 广告活动ID |
| 6.1.8 | campaignName | 广告活动名称 | string | 秋季广告活动 | Required | 广告活动名称 |
| 6.1.9 | campaignStatusCode | 广告活动状态编码 | string | active | Required | 广告活动状态编码,取值:active-已启用 paused-已暂停 |
| 6.1.10 | itemId | itemId | string | MLM1234567890 | Required | itemId |
| 6.1.11 | title | 标题 | string | 运动鞋 | Required | 标题 |
| 6.1.12 | price | 价格 | string | 0 | Required | 价格 |
| 6.1.13 | quantity | 总库存 | integer | 1 | Required | 总库存 |
| 6.1.14 | availableQuantity | 可用库存 | integer | 1 | Required | 可用库存 |
| 6.1.15 | variations | 包含变体信息 | array<object> | — | Required | 包含变体信息 |
| 6.1.15.1 | variationId | 变体ID | string | 123456789 | Required | 变体ID |
| 6.1.15.2 | sku | sku | string | SKU-001 | Required | SKU |
| 6.1.15.3 | quantity | 总库存 | integer | 1 | Required | 总库存 |
| 6.1.15.4 | availableQuantity | 可用库存 | integer | 1 | Required | 可用库存 |
| 6.1.16 | imageUrl | 图片URL | string | https://example.com/product.jpg | Required | 图片URL |
| 6.1.17 | statusCode | 状态编码 | string | active | Required | 状态编码,取值:active-已启用 paused-已暂停 hold-已下架 deleted-已归档 |
| 6.1.18 | statusDisplayName | 状态显示名称 | string | 已启用 | Required | 状态显示名称,默认文案:active-已启用 paused-已暂停 hold-已下架 deleted-已归档,实际文案随语言变化。 |
| 6.1.19 | serviceStatus | 投放服务状态文案 | string | 投放中 | Required | 投放服务状态文案,由原始状态映射,默认取值:投放中、已暂停、投放停止、闲置中、已下架、审核中。对应原始状态:A-投放中、P-已暂停、S-投放停止、I-闲置中、C-已下架、U-审核中;实际返回文案随语言变化,未识别时为 null。 |
| 6.1.20 | buyBoxWinnerCode | 赢得购物车编码 | integer | 1 | Required | 赢得购物车编码,取值:0-未赢得、1-已赢得 |
| 6.1.21 | includeVariant | 包含变体 | integer | 1 | Required | 包含变体,取值:0-不包含、1-包含;未获取到库存变体信息时为 null。 |
| 6.1.22 | discountStatusCode | 折扣状态 | integer | 1 | Required | 折扣状态,取值:1-折扣中、其他-无 |
| 6.1.23 | permalink | 永久项目链接 | string | https://example.com/product | Required | 永久项目链接 |
| 6.1.24 | impressions | 曝光量 | string | 0 | Required | 曝光量 |
| 6.1.25 | clicks | 点击量 | string | 0 | Required | 点击量 |
| 6.1.26 | spend | 花费 | string | 0 | Required | 花费 |
| 6.1.27 | organicUnitsSold | 自然销量 | string | 0 | Required | 自然销量 |
| 6.1.28 | adUnitsSold | 广告销量 | string | 0 | Required | 广告销量 |
| 6.1.29 | organicSales | 自然销售额 | string | 0 | Required | 自然销售额 |
| 6.1.30 | adSales | 广告销售额 | string | 0 | Required | 广告销售额 |
| 6.1.31 | directSales | 广告直接成交销售额 | string | 0 | Required | 广告直接成交销售额 |
| 6.1.32 | indirectSales | 广告间接成交销售额 | string | 0 | Required | 广告间接成交销售额 |
| 6.1.33 | organicItemsSold | 自然销售产品数 | string | 0 | Required | 自然销售产品数 |
| 6.1.34 | adItemsSold | 广告销售产品数 | string | 0 | Required | 广告销售产品数 |
| 6.1.35 | directItemsSold | 广告直接销售产品数 | string | 0 | Required | 广告直接销售产品数 |
| 6.1.36 | indirectItemsSold | 广告间接销售产品数 | string | 0 | Required | 广告间接销售产品数 |
| 6.1.37 | adOrders | 广告订单 | string | 0 | Required | 广告订单 |
| 6.1.38 | totalUnitsSold | 店铺销量 | string | 0 | Required | 店铺销量 |
| 6.1.39 | totalSales | 店铺销售额 | string | 0 | Required | 店铺销售额 |
| 6.1.40 | totalItemsSold | 店铺销售产品数 | string | 0 | Required | 店铺销售产品数 |
| 6.1.41 | ctr | ctr | string | 0 | Required | CTR |
| 6.1.42 | cpc | cpc | string | 0 | Required | CPC |
| 6.1.43 | cvr | cvr | string | 0 | Required | CVR |
| 6.1.44 | cpa | cpa | string | 0 | Required | CPA |
| 6.1.45 | adUnitsSoldShare | 广告销量占比 | string | 0 | Required | 广告销量占比 |
| 6.1.46 | sov | sov | string | 0 | Required | sov |
| 6.1.47 | adUnitPrice | 广告笔单价 | string | 0 | Required | 广告笔单价 |
| 6.1.48 | racos | racos | string | 0 | Required | RACoS |
| 6.1.49 | roas | roas | string | 0 | Required | ROAS |
| 6.1.50 | tacos | tacos | string | 0 | Required | TACoS |
| 6.1.51 | impressionsPercent | 曝光量百分比 | string | 0 | Required | 曝光量百分比 |
| 6.1.52 | clicksPercent | 点击量百分比 | string | 0 | Required | 点击量百分比 |
| 6.1.53 | spendPercent | 花费百分比 | string | 0 | Required | 花费百分比 |
| 6.1.54 | adOrdersPercent | 广告订单百分比 | string | 0 | Required | 广告订单百分比 |
| 6.1.55 | organicUnitsSoldPercent | 自然销量百分比 | string | 0 | Required | 自然销量百分比 |
| 6.1.56 | adUnitsSoldPercent | 广告销量百分比 | string | 0 | Required | 广告销量百分比 |
| 6.1.57 | organicSalesPercent | 自然销售额百分比 | string | 0 | Required | 自然销售额百分比 |
| 6.1.58 | adSalesPercent | 广告销售额百分比 | string | 0 | Required | 广告销售额百分比 |
| 6.1.59 | 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/adItem/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.