美客多广告 - 查询活动报告列表
POST
/basicOpen/mercadoAd/campaign/report/list支持按日期范围查询美客多广告活动报告列表。
接口信息
| API Path | 请求协议 | 请求方式 | 令牌桶容量 |
|---|---|---|---|
/basicOpen/mercadoAd/campaign/report/list | HTTPS | POST | 1 |
请求参数
statusCodesarray<any>channelCodesarray<any>advertiserIdsarray<any>adItemIdsarray<any>searchTextstringrequestFilterobject隐藏子属性
spendarray<any>cpaarray<any>directUnitsSoldarray<any>indirectUnitsSoldarray<any>impressionsarray<any>clicksarray<any>ctrarray<any>cpcarray<any>totalUnitsSoldarray<any>organicUnitsSoldarray<any>adUnitsSoldarray<any>totalSalesarray<any>organicSalesarray<any>adSalesarray<any>adUnitPricearray<any>directSalesarray<any>indirectSalesarray<any>racosarray<any>roasarray<any>tacosarray<any>totalItemsSoldarray<any>organicItemsSoldarray<any>adItemsSoldarray<any>sovarray<any>pageintegerlengthintegerorderFieldstringorderTypestringsummaryCurrencyCodestringstartDatestring必填endDatestring必填请求cURL示例
curl --location 'https://openapi.lingxing.com/basicOpen/mercadoAd/campaign/report/list?access_token=value×tamp=value&sign=value&app_key=value' \
--header 'Content-Type: application/json' \
--data '{
"statusCodes": [
"active"
],
"channelCodes": [
"marketplace"
],
"advertiserIds": [
"123456"
],
"adItemIds": [
"MLM1234567890"
],
"page": 1,
"length": 20,
"orderField": "spend",
"orderType": "DESC",
"summaryCurrencyCode": "USD",
"startDate": "2026-09-01",
"endDate": "2026-09-15"
}'返回结果
Json Object
codeinteger必填messagestring必填error_detailsarray<any>必填request_idstring必填response_timestring必填dataobject必填隐藏子属性
listarray<object>必填隐藏子属性
advertiserIdstring必填advertiserNamestring必填storeIdstring必填siteIdstring必填storeNamestring必填modestring必填campaignIdstring必填campaignNamestring必填statusCodestring必填statusDisplayNamestring必填targetAcosstring必填targetRoasstring必填dailyBudgetstring必填storeCurrencyCodestring必填adItemsarray<object>必填隐藏子属性
itemIdstring必填titlestring必填pricestring必填stockstring必填imageUrlstring必填quantityinteger必填availableQuantityinteger必填impressionsstring必填clicksstring必填spendstring必填organicUnitsSoldstring必填adUnitsSoldstring必填directUnitsSoldstring必填indirectUnitsSoldstring必填organicSalesstring必填adSalesstring必填directSalesstring必填indirectSalesstring必填organicItemsSoldstring必填adItemsSoldstring必填directItemsSoldstring必填indirectItemsSoldstring必填adOrdersstring必填totalUnitsSoldstring必填totalSalesstring必填totalItemsSoldstring必填impressionsSharestring必填searchPositionTopImpressionsSharestring必填lostImpressionsShareBudgetShortfallstring必填lostImpressionsShareRankShortfallstring必填ctrstring必填cpcstring必填cvrstring必填cpastring必填adUnitsSoldSharestring必填sovstring必填adUnitPricestring必填racosstring必填roasstring必填tacosstring必填impressionsPercentstring必填clicksPercentstring必填spendPercentstring必填adOrdersPercentstring必填organicUnitsSoldPercentstring必填adUnitsSoldPercentstring必填organicSalesPercentstring必填adSalesPercentstring必填currencyCodestring必填totalinteger必填totalinteger必填返回成功示例
{
"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": "秋季广告活动",
"statusCode": "active",
"statusDisplayName": "已启用",
"targetAcos": "0",
"targetRoas": "0",
"dailyBudget": "0",
"storeCurrencyCode": "MXN",
"adItems": [
{
"itemId": "MLM1234567890",
"title": "运动鞋",
"price": "0",
"stock": "0",
"imageUrl": "https://example.com/product.jpg"
}
],
"quantity": 1,
"availableQuantity": 1,
"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
}