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) · 响应参数 72 个 · 限流令牌桶容量 1
Updated At
2026-11-21

美客多广告 - 查询商品报告列表

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

Request Parameters

No.FieldNameTypeDefaultRequiredDescription
1statusCodes状态编码取值array<any>—Optional状态编码取值:active-已启用 paused-已暂停 hold-已下架 deleted-已归档
2channelCodes渠道编码array<any>—Optional渠道编码,取值:marketplace
3advertiserIds广告账号IDarray<any>—Optional广告账号ID
4campaignIds广告活动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-广告销量占比 totalSales-店铺销售额 organicSales-自然销售额 organicSalesPercent-自然销售额百分比 adSales-广告销售额 adSalesPercent-广告销售额百分比 sov-sov adUnitPrice-广告笔单价 directSales-广告直接成交销售额 indirectSales-广告间接成交销售额 racos-RACoS roas-ROAS tacos-TACoS totalItemsSold-店铺销售产品数 organicItemsSold-自然销售产品数 adItemsSold-广告销售产品数 directItemsSold-广告直接销售产品数 indirectItemsSold-广告间接销售产品数 未传时按商品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.9campaignStatusCode广告活动状态编码stringactiveRequired广告活动状态编码,取值:active-已启用 paused-已暂停
6.1.10itemIditemIdstringMLM1234567890RequireditemId
6.1.11title标题string运动鞋Required标题
6.1.12price价格string0Required价格
6.1.13quantity总库存integer1Required总库存
6.1.14availableQuantity可用库存integer1Required可用库存
6.1.15variations包含变体信息array<object>—Required包含变体信息
6.1.15.1variationId变体IDstring123456789Required变体ID
6.1.15.2skuskustringSKU-001RequiredSKU
6.1.15.3quantity总库存integer1Required总库存
6.1.15.4availableQuantity可用库存integer1Required可用库存
6.1.16imageUrl图片URLstringhttps://example.com/product.jpgRequired图片URL
6.1.17statusCode状态编码stringactiveRequired状态编码,取值:active-已启用 paused-已暂停 hold-已下架 deleted-已归档
6.1.18statusDisplayName状态显示名称string已启用Required状态显示名称,默认文案:active-已启用 paused-已暂停 hold-已下架 deleted-已归档,实际文案随语言变化。
6.1.19serviceStatus投放服务状态文案string投放中Required投放服务状态文案,由原始状态映射,默认取值:投放中、已暂停、投放停止、闲置中、已下架、审核中。对应原始状态:A-投放中、P-已暂停、S-投放停止、I-闲置中、C-已下架、U-审核中;实际返回文案随语言变化,未识别时为 null。
6.1.20buyBoxWinnerCode赢得购物车编码integer1Required赢得购物车编码,取值:0-未赢得、1-已赢得
6.1.21includeVariant包含变体integer1Required包含变体,取值:0-不包含、1-包含;未获取到库存变体信息时为 null。
6.1.22discountStatusCode折扣状态integer1Required折扣状态,取值:1-折扣中、其他-无
6.1.23permalink永久项目链接stringhttps://example.com/productRequired永久项目链接
6.1.24impressions曝光量string0Required曝光量
6.1.25clicks点击量string0Required点击量
6.1.26spend花费string0Required花费
6.1.27organicUnitsSold自然销量string0Required自然销量
6.1.28adUnitsSold广告销量string0Required广告销量
6.1.29organicSales自然销售额string0Required自然销售额
6.1.30adSales广告销售额string0Required广告销售额
6.1.31directSales广告直接成交销售额string0Required广告直接成交销售额
6.1.32indirectSales广告间接成交销售额string0Required广告间接成交销售额
6.1.33organicItemsSold自然销售产品数string0Required自然销售产品数
6.1.34adItemsSold广告销售产品数string0Required广告销售产品数
6.1.35directItemsSold广告直接销售产品数string0Required广告直接销售产品数
6.1.36indirectItemsSold广告间接销售产品数string0Required广告间接销售产品数
6.1.37adOrders广告订单string0Required广告订单
6.1.38totalUnitsSold店铺销量string0Required店铺销量
6.1.39totalSales店铺销售额string0Required店铺销售额
6.1.40totalItemsSold店铺销售产品数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/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.

Need to integrate this API?

Qeasy ships with prebuilt adaptation for this API — contact us to start configuring data integration.