轻易云
注册体验

领星ERP分页查询店铺报告列表接口

所属平台
领星ERP
类型
WebAPI
作用
QUERY
接口版本
1.0
适配器
\Adapter\LingXing\LXQueryAdapter
授权方式
OTHER
描述
多平台 / 广告 / Shopee广告 · POST SS · 请求参数 11 个(必填 8) · 响应参数 38 个 · 限流令牌桶容量 1
更新日期
2026-11-21

分页查询店铺报告列表

POST/basicOpen/multiplatform/ads/shopee/store/report/list
加工厂
{
  "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
        }
      ]
    }
  }
}

接口请求参数

序号字段名称类型默认值必填描述
1page分页参数对象object—必填分页参数对象
1.1page当前页码number1必填当前页码,从 1 开始
1.2length每页大小number20必填每页大小
1.3orderField排序字段stringcost必填排序字段,按返回字段名称排序
1.4orderType排序类型stringdesc必填排序类型: asc 升序 desc 降序
2period时间范围对象object{"startDate":"2026-03-01","endDate":"2026-03-17"}必填时间范围对象
2.1startDate开始日期string2026-03-01必填开始日期,格式:yyyy-MM-dd
2.2endDate结束日期string2026-03-17必填结束日期,格式:yyyy-MM-dd
3filter筛选条件对象object{"shopIds":[10001,10002],"isSyncList":[1]}可选筛选条件对象
3.1shopIds店铺ID列表(复选array<any>[10001,10002]可选店铺ID列表(复选,为空则代表全部)
3.2isSyncList店铺同步状态列表(复选array<any>[1]可选店铺同步状态列表(复选,为空时为全部): 0 停用 1 启用

接口响应参数

序号字段名称类型默认值必填描述
1code状态码number0必填状态码,0:成功
2message消息提示stringsuccess必填消息提示
3error_details数据校验失败时的错误详情array<any>[]必填数据校验失败时的错误详情
4request_id请求链路idstringccafcc7d9a72484fac5a3889b5db2986.231.17611516492143035必填请求链路id
5response_time响应时间string2025-10-23 00:47:29必填响应时间
6data响应数据object—必填响应数据
6.1total总记录数number128必填总记录数
6.2page当前页码number1必填当前页码
6.3length每页大小number20必填每页大小
6.4list数据列表array<object>—必填数据列表
6.4.1dimension唯一标识string10001可选唯一标识,数据行为店铺ID的字符串形式
6.4.2currencyCode币种代码stringUSD可选币种代码
6.4.3storeId店铺IDnumber10001可选店铺ID
6.4.4storeName店铺名称stringShopee SG Store可选店铺名称
6.4.5shopIdShopee 店铺IDnumber900001可选Shopee 店铺ID
6.4.6lxName店铺展示名称stringShopee-SG-001可选店铺展示名称
6.4.7isSync同步状态number1可选同步状态: 0 停用 1 启用
6.4.8isSyncDisplayName同步状态显示名称(国际化)string启用可选同步状态显示名称(国际化)
6.4.9impression曝光量number15000可选曝光量
6.4.10clicks点击量number850可选点击量
6.4.11cost广告花费number320.5可选广告花费
6.4.12directOrder广告订单(直接订单)number35可选广告订单(直接订单)
6.4.13broadOrder间接订单number12可选间接订单
6.4.14directItemSold广告销量(直接售出商品数)number42可选广告销量(直接售出商品数)
6.4.15broadItemSold间接销量(间接售出商品数)number16可选间接销量(间接售出商品数)
6.4.16directGmv广告GMV(直接GMV)number980.6可选广告GMV(直接GMV)
6.4.17broadGmv间接GMVnumber210.4可选间接GMV
6.4.18clickPercent点击百分比(点击量占查询结果总点击量的百分比)number12.36可选点击百分比(点击量占查询结果总点击量的百分比)
6.4.19ctrctrnumber5.67可选CTR - 点击率(点击量/曝光量 * 100%)
6.4.20cpcCPC - 每次点击成本(广告花费/点击量)number0.38可选CPC - 每次点击成本(广告花费/点击量)
6.4.21directCvrdirectCvrnumber4.12可选CVR - 转化率(广告订单/点击量 * 100%)
6.4.22broadCvrbroadCvrnumber1.41可选间接CVR - 间接转化率(间接订单/点击量 * 100%)
6.4.23directCpaCPA - 每笔订单花费(广告花费/广告订单)number9.16可选CPA - 每笔订单花费(广告花费/广告订单)
6.4.24broadCpabroadCpanumber26.71可选间接CPA - 每笔间接订单花费(广告花费/间接订单)
6.4.25directRoasdirectRoasnumber3.06可选广告ROAS - 广告支出回报率(广告GMV/广告花费)
6.4.26broadRoasbroadRoasnumber0.66可选间接ROAS - 间接广告支出回报率(间接GMV/广告花费)
6.4.27directAcosdirectAcosnumber32.68可选广告ACoS - 广告销售成本(广告花费/广告GMV * 100%)
6.4.28broadAcosbroadAcosnumber152.33可选间接ACoS - 间接广告销售成本(广告花费/间接GMV * 100%)

领星ERP的接口:分页查询店铺报告列表(/basicOpen/multiplatform/ads/shopee/store/report/list),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。

需要对接这个接口?

轻易云已预置该接口的适配能力,联系我们即可开始配置数据集成。