Qeasy Cloud
Get Started

领星ERP 分页查询广告活动报告列表 API

Platform
领星ERP
Type
WebAPI
Effect
QUERY
API Version
1.0
Adapter
\Adapter\LingXing\LXQueryAdapter
Auth Mode
OTHER
Description
多平台 / 广告 / Shopee广告 · POST · 请求参数 15 个(必填 8) · 响应参数 54 个 · 限流令牌桶容量 1
Updated At
2026-11-21

分页查询广告活动报告列表

POST/basicOpen/multiplatform/ads/shopee/campaign/report/list
Factory
{
  "operation": {
    "method": "POST",
    "path": "/basicOpen/multiplatform/ads/shopee/campaign/report/list"
  },
  "protocol": "HTTPS",
  "host": "https://openapi.lingxing.com",
  "rateLimit": {
    "tokenBucketCapacity": 1,
    "text": ""
  },
  "requestExample": "curl --location 'https://openapi.lingxing.com/basicOpen/multiplatform/ads/shopee/campaign/report/list?access_token=value&timestamp=value&sign=value&app_key=value' \\\n--header 'Content-Type: application/json' \\\n--data '{\n    \"page\": {\n        \"page\": 1,\n        \"length\": 20,\n        \"orderField\": \"cost\",\n        \"orderType\": \"desc\"\n    },\n    \"period\": {\n        \"startDate\": \"2026-03-01\",\n        \"endDate\": \"2026-03-17\"\n    },\n    \"filter\": {\n        \"shopIds\": [10001,10002],\n        \"campaignIds\": [20001,20002],\n        \"campaignName\": \"春季大促\",\n        \"statusCodes\": [\"ongoing\",\"paused\"],\n        \"placementCategories\": [\"search\",\"discovery\"],\n        \"itemIds\": [30001,30002]\n    }\n}'",
  "responseExample": {
    "code": 0,
    "message": "success",
    "error_details": [],
    "request_id": "ccafcc7d9a72484fac5a3889b5db2986.231.17611516492143035",
    "response_time": "2025-10-23 00:47:29",
    "data": {
      "total": 128,
      "page": 1,
      "length": 20,
      "list": [
        {
          "dimension": "campaign-20001",
          "itemIds": [
            "30001",
            "30002"
          ],
          "currencyCode": "USD",
          "campaignId": 20001,
          "campaignName": "Shopee 春季大促",
          "storeId": 10001,
          "shopId": 900001,
          "lxName": "Shopee-SG-001",
          "statusCode": "ongoing",
          "statusDisplayName": "进行中",
          "startTime": "2026-03-01 00:00:00",
          "endTime": "2026-03-31 23:59:59",
          "targetType": "manual",
          "targetTypeDisplayName": "手动",
          "biddingType": "auto",
          "biddingTypeDisplayName": "自动",
          "placementCategory": "search",
          "placementCategoryDisplayName": "搜索",
          "campaignBudget": 1000.5,
          "roasTarget": 2.5,
          "dailyDiscoverStatus": "active",
          "dailyDiscoverBid": 0.3,
          "youMayAlsoLikeStatus": "inactive",
          "youMayAlsoLikeBid": 0.25,
          "impression": 15000,
          "clicks": 850,
          "cost": 320.5,
          "directOrder": 35,
          "broadOrder": 12,
          "directItemSold": 42,
          "broadItemSold": 16,
          "directGmv": 980.6,
          "broadGmv": 210.4,
          "clickPercent": 12.36,
          "ctr": 5.67,
          "cpc": 0.38,
          "directCvr": 4.12,
          "broadCvr": 1.41,
          "directCpa": 9.16,
          "broadCpa": 26.71,
          "directRoas": 3.06,
          "broadRoas": 0.66,
          "directAcos": 32.68,
          "broadAcos": 152.33
        }
      ]
    }
  }
}

Request Parameters

No.FieldNameTypeDefaultRequiredDescription
1page分页参数对象object—Required分页参数对象
1.1page当前页码number—Required当前页码,从 1 开始
1.2length每页大小number—Required每页大小
1.3orderField排序字段string—Required排序字段,按返回字段名称排序
1.4orderType排序类型string—Required排序类型: asc 升序 desc 降序
2period时间范围对象object—Required时间范围对象
2.1startDate开始日期string—Required开始日期,格式:yyyy-MM-dd
2.2endDate结束日期string—Required结束日期,格式:yyyy-MM-dd
3filter筛选条件对象object—Optional筛选条件对象
3.1shopIds店铺ID列表(复选array<any>—Optional店铺ID列表(复选,为空则代表全部)
3.2campaignIds广告活动ID列表(复选array<any>—Optional广告活动ID列表(复选,为空则代表全部)
3.3campaignName广告活动名称(模糊搜索)string—Optional广告活动名称(模糊搜索)
3.4statusCodes广告活动状态列表(复选array<any>—Optional广告活动状态列表(复选,为空时为全部): ongoing 进行中 scheduled 已计划 ended 已结束 paused 已暂停 deleted 已删除 closed 已关闭
3.5placementCategories广告位类别列表(复选array<any>—Optional广告位类别列表(复选,为空时为全部): search 搜索 discovery 展示 all 全部
3.6itemIds商品ID列表(复选array<any>—Optional商品ID列表(复选,为空则代表全部)

Response Parameters

No.FieldNameTypeDefaultRequiredDescription
1code状态码number0Required状态码,0:成功
2message消息提示stringsuccessRequired消息提示
3error_details数据校验失败时的错误详情array<any>[]Required数据校验失败时的错误详情
4request_id请求链路idstringccafcc7d9a72484fac5a3889b5db2986.231.17611516492143035Required请求链路id
5response_time响应时间string2025-10-23 00:47:29Required响应时间
6data响应数据object—Required响应数据
6.1total总记录数number128Required总记录数
6.2page当前页码number1Required当前页码
6.3length每页大小number20Required每页大小
6.4list数据列表array<object>—Required数据列表
6.4.1dimension唯一标识stringcampaign-20001Optional唯一标识
6.4.2itemIds商品ID列表array<any>["30001","30002"]Required商品ID列表
6.4.3currencyCode币种代码stringUSDOptional币种代码
6.4.4campaignId广告活动IDnumber20001Optional广告活动ID
6.4.5campaignName广告活动名称stringShopee 春季大促Optional广告活动名称
6.4.6storeId店铺IDnumber10001Optional店铺ID
6.4.7shopIdShopee 店铺IDnumber900001OptionalShopee 店铺ID
6.4.8lxName店铺展示名称stringShopee-SG-001Optional店铺展示名称
6.4.9statusCode广告活动状态编码stringongoingOptional广告活动状态编码: ongoing 进行中 scheduled 已计划 ended 已结束 paused 已暂停 deleted 已删除 closed 已关闭
6.4.10statusDisplayName状态显示名称(国际化)string进行中Optional状态显示名称(国际化)
6.4.11startTime广告活动开始时间string2026-03-01 00:00:00Optional广告活动开始时间
6.4.12endTime广告活动结束时间string2026-03-31 23:59:59Optional广告活动结束时间
6.4.13targetType预算类型stringmanualOptional预算类型: auto 自动 manual 手动
6.4.14targetTypeDisplayName预算类型显示名称(国际化)string手动Optional预算类型显示名称(国际化)
6.4.15biddingType竞价类型stringautoOptional竞价类型: auto 自动 manual 手动
6.4.16biddingTypeDisplayName竞价类型显示名称(国际化)string自动Optional竞价类型显示名称(国际化)
6.4.17placementCategory广告位类别stringsearchOptional广告位类别: search 搜索 discovery 展示 all 全部
6.4.18placementCategoryDisplayName广告位类别显示名称(国际化)string搜索Optional广告位类别显示名称(国际化)
6.4.19campaignBudget广告活动预算number1000.5Optional广告活动预算
6.4.20roasTarget目标ROASnumber2.5Optional目标ROAS
6.4.21dailyDiscoverStatus每日发现广告位状态stringactiveOptional每日发现广告位状态: active 启用 inactive 停用
6.4.22dailyDiscoverBid每日发现广告位竞价number0.3Optional每日发现广告位竞价
6.4.23youMayAlsoLikeStatus猜你喜欢广告位状态stringinactiveOptional猜你喜欢广告位状态: active 启用 inactive 停用
6.4.24youMayAlsoLikeBid猜你喜欢广告位竞价number0.25Optional猜你喜欢广告位竞价
6.4.25impression曝光量number15000Optional曝光量
6.4.26clicks点击量number850Optional点击量
6.4.27cost广告花费number320.5Optional广告花费
6.4.28directOrder广告订单(直接订单)number35Optional广告订单(直接订单)
6.4.29broadOrder间接订单number12Optional间接订单
6.4.30directItemSold广告销量(直接售出商品数)number42Optional广告销量(直接售出商品数)
6.4.31broadItemSold间接销量(间接售出商品数)number16Optional间接销量(间接售出商品数)
6.4.32directGmv广告GMV(直接GMV)number980.6Optional广告GMV(直接GMV)
6.4.33broadGmv间接GMVnumber210.4Optional间接GMV
6.4.34clickPercent点击百分比(点击量占查询结果总点击量的百分比)number12.36Optional点击百分比(点击量占查询结果总点击量的百分比)
6.4.35ctrctrnumber5.67OptionalCTR - 点击率(点击量/曝光量 * 100%)
6.4.36cpcCPC - 每次点击成本(广告花费/点击量)number0.38OptionalCPC - 每次点击成本(广告花费/点击量)
6.4.37directCvrdirectCvrnumber4.12OptionalCVR - 转化率(广告订单/点击量 * 100%)
6.4.38broadCvrbroadCvrnumber1.41Optional间接CVR - 间接转化率(间接订单/点击量 * 100%)
6.4.39directCpaCPA - 每笔订单花费(广告花费/广告订单)number9.16OptionalCPA - 每笔订单花费(广告花费/广告订单)
6.4.40broadCpabroadCpanumber26.71Optional间接CPA - 每笔间接订单花费(广告花费/间接订单)
6.4.41directRoasdirectRoasnumber3.06Optional广告ROAS - 广告支出回报率(广告GMV/广告花费)
6.4.42broadRoasbroadRoasnumber0.66Optional间接ROAS - 间接广告支出回报率(间接GMV/广告花费)
6.4.43directAcosdirectAcosnumber32.68Optional广告ACoS - 广告销售成本(广告花费/广告GMV * 100%)
6.4.44broadAcosbroadAcosnumber152.33Optional间接ACoS - 间接广告销售成本(广告花费/间接GMV * 100%)

The 分页查询广告活动报告列表 API (/basicOpen/multiplatform/ads/shopee/campaign/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.