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 SS · 请求参数 11 个(必填 8) · 响应参数 38 个 · 限流令牌桶容量 1
Updated At
2026-11-21

分页查询店铺报告列表

POST/basicOpen/multiplatform/ads/shopee/store/report/list
Factory
{
  "operation": {
    "method": "POST",
    "path": "/basicOpen/multiplatform/ads/shopee/store/report/list"
  },
  "protocol": "HTTPS",
  "host": "https://openapi.lingxing.com",
  "rateLimit": {
    "tokenBucketCapacity": 1,
    "text": ""
  },
  "requestExample": "curl --location 'https://openapi.lingxing.com/basicOpen/multiplatform/ads/shopee/store/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        \"isSyncList\": [1]\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": "10001",
          "currencyCode": "USD",
          "storeId": 10001,
          "storeName": "Shopee SG Store",
          "shopId": 900001,
          "lxName": "Shopee-SG-001",
          "isSync": 1,
          "isSyncDisplayName": "启用",
          "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当前页码number1Required当前页码,从 1 开始
1.2length每页大小number20Required每页大小
1.3orderField排序字段stringcostRequired排序字段,按返回字段名称排序
1.4orderType排序类型stringdescRequired排序类型: asc 升序 desc 降序
2period时间范围对象object{"startDate":"2026-03-01","endDate":"2026-03-17"}Required时间范围对象
2.1startDate开始日期string2026-03-01Required开始日期,格式:yyyy-MM-dd
2.2endDate结束日期string2026-03-17Required结束日期,格式:yyyy-MM-dd
3filter筛选条件对象object{"shopIds":[10001,10002],"isSyncList":[1]}Optional筛选条件对象
3.1shopIds店铺ID列表(复选array<any>[10001,10002]Optional店铺ID列表(复选,为空则代表全部)
3.2isSyncList店铺同步状态列表(复选array<any>[1]Optional店铺同步状态列表(复选,为空时为全部): 0 停用 1 启用

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唯一标识string10001Optional唯一标识,数据行为店铺ID的字符串形式
6.4.2currencyCode币种代码stringUSDOptional币种代码
6.4.3storeId店铺IDnumber10001Optional店铺ID
6.4.4storeName店铺名称stringShopee SG StoreOptional店铺名称
6.4.5shopIdShopee 店铺IDnumber900001OptionalShopee 店铺ID
6.4.6lxName店铺展示名称stringShopee-SG-001Optional店铺展示名称
6.4.7isSync同步状态number1Optional同步状态: 0 停用 1 启用
6.4.8isSyncDisplayName同步状态显示名称(国际化)string启用Optional同步状态显示名称(国际化)
6.4.9impression曝光量number15000Optional曝光量
6.4.10clicks点击量number850Optional点击量
6.4.11cost广告花费number320.5Optional广告花费
6.4.12directOrder广告订单(直接订单)number35Optional广告订单(直接订单)
6.4.13broadOrder间接订单number12Optional间接订单
6.4.14directItemSold广告销量(直接售出商品数)number42Optional广告销量(直接售出商品数)
6.4.15broadItemSold间接销量(间接售出商品数)number16Optional间接销量(间接售出商品数)
6.4.16directGmv广告GMV(直接GMV)number980.6Optional广告GMV(直接GMV)
6.4.17broadGmv间接GMVnumber210.4Optional间接GMV
6.4.18clickPercent点击百分比(点击量占查询结果总点击量的百分比)number12.36Optional点击百分比(点击量占查询结果总点击量的百分比)
6.4.19ctrctrnumber5.67OptionalCTR - 点击率(点击量/曝光量 * 100%)
6.4.20cpcCPC - 每次点击成本(广告花费/点击量)number0.38OptionalCPC - 每次点击成本(广告花费/点击量)
6.4.21directCvrdirectCvrnumber4.12OptionalCVR - 转化率(广告订单/点击量 * 100%)
6.4.22broadCvrbroadCvrnumber1.41Optional间接CVR - 间接转化率(间接订单/点击量 * 100%)
6.4.23directCpaCPA - 每笔订单花费(广告花费/广告订单)number9.16OptionalCPA - 每笔订单花费(广告花费/广告订单)
6.4.24broadCpabroadCpanumber26.71Optional间接CPA - 每笔间接订单花费(广告花费/间接订单)
6.4.25directRoasdirectRoasnumber3.06Optional广告ROAS - 广告支出回报率(广告GMV/广告花费)
6.4.26broadRoasbroadRoasnumber0.66Optional间接ROAS - 间接广告支出回报率(间接GMV/广告花费)
6.4.27directAcosdirectAcosnumber32.68Optional广告ACoS - 广告销售成本(广告花费/广告GMV * 100%)
6.4.28broadAcosbroadAcosnumber152.33Optional间接ACoS - 间接广告销售成本(广告花费/间接GMV * 100%)

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

Need to integrate this API?

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