/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×tamp=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
}
]
}
}
}| 序号 | 字段 | 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| 1 | page | 分页参数对象 | object | — | 必填 | 分页参数对象 |
| 1.1 | page | 当前页码 | number | 1 | 必填 | 当前页码,从 1 开始 |
| 1.2 | length | 每页大小 | number | 20 | 必填 | 每页大小 |
| 1.3 | orderField | 排序字段 | string | cost | 必填 | 排序字段,按返回字段名称排序 |
| 1.4 | orderType | 排序类型 | string | desc | 必填 | 排序类型: asc 升序 desc 降序 |
| 2 | period | 时间范围对象 | object | {"startDate":"2026-03-01","endDate":"2026-03-17"} | 必填 | 时间范围对象 |
| 2.1 | startDate | 开始日期 | string | 2026-03-01 | 必填 | 开始日期,格式:yyyy-MM-dd |
| 2.2 | endDate | 结束日期 | string | 2026-03-17 | 必填 | 结束日期,格式:yyyy-MM-dd |
| 3 | filter | 筛选条件对象 | object | {"shopIds":[10001,10002],"isSyncList":[1]} | 可选 | 筛选条件对象 |
| 3.1 | shopIds | 店铺ID列表(复选 | array<any> | [10001,10002] | 可选 | 店铺ID列表(复选,为空则代表全部) |
| 3.2 | isSyncList | 店铺同步状态列表(复选 | array<any> | [1] | 可选 | 店铺同步状态列表(复选,为空时为全部): 0 停用 1 启用 |
| 序号 | 字段 | 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| 1 | code | 状态码 | number | 0 | 必填 | 状态码,0:成功 |
| 2 | message | 消息提示 | string | success | 必填 | 消息提示 |
| 3 | error_details | 数据校验失败时的错误详情 | array<any> | [] | 必填 | 数据校验失败时的错误详情 |
| 4 | request_id | 请求链路id | string | ccafcc7d9a72484fac5a3889b5db2986.231.17611516492143035 | 必填 | 请求链路id |
| 5 | response_time | 响应时间 | string | 2025-10-23 00:47:29 | 必填 | 响应时间 |
| 6 | data | 响应数据 | object | — | 必填 | 响应数据 |
| 6.1 | total | 总记录数 | number | 128 | 必填 | 总记录数 |
| 6.2 | page | 当前页码 | number | 1 | 必填 | 当前页码 |
| 6.3 | length | 每页大小 | number | 20 | 必填 | 每页大小 |
| 6.4 | list | 数据列表 | array<object> | — | 必填 | 数据列表 |
| 6.4.1 | dimension | 唯一标识 | string | 10001 | 可选 | 唯一标识,数据行为店铺ID的字符串形式 |
| 6.4.2 | currencyCode | 币种代码 | string | USD | 可选 | 币种代码 |
| 6.4.3 | storeId | 店铺ID | number | 10001 | 可选 | 店铺ID |
| 6.4.4 | storeName | 店铺名称 | string | Shopee SG Store | 可选 | 店铺名称 |
| 6.4.5 | shopId | Shopee 店铺ID | number | 900001 | 可选 | Shopee 店铺ID |
| 6.4.6 | lxName | 店铺展示名称 | string | Shopee-SG-001 | 可选 | 店铺展示名称 |
| 6.4.7 | isSync | 同步状态 | number | 1 | 可选 | 同步状态: 0 停用 1 启用 |
| 6.4.8 | isSyncDisplayName | 同步状态显示名称(国际化) | string | 启用 | 可选 | 同步状态显示名称(国际化) |
| 6.4.9 | impression | 曝光量 | number | 15000 | 可选 | 曝光量 |
| 6.4.10 | clicks | 点击量 | number | 850 | 可选 | 点击量 |
| 6.4.11 | cost | 广告花费 | number | 320.5 | 可选 | 广告花费 |
| 6.4.12 | directOrder | 广告订单(直接订单) | number | 35 | 可选 | 广告订单(直接订单) |
| 6.4.13 | broadOrder | 间接订单 | number | 12 | 可选 | 间接订单 |
| 6.4.14 | directItemSold | 广告销量(直接售出商品数) | number | 42 | 可选 | 广告销量(直接售出商品数) |
| 6.4.15 | broadItemSold | 间接销量(间接售出商品数) | number | 16 | 可选 | 间接销量(间接售出商品数) |
| 6.4.16 | directGmv | 广告GMV(直接GMV) | number | 980.6 | 可选 | 广告GMV(直接GMV) |
| 6.4.17 | broadGmv | 间接GMV | number | 210.4 | 可选 | 间接GMV |
| 6.4.18 | clickPercent | 点击百分比(点击量占查询结果总点击量的百分比) | number | 12.36 | 可选 | 点击百分比(点击量占查询结果总点击量的百分比) |
| 6.4.19 | ctr | ctr | number | 5.67 | 可选 | CTR - 点击率(点击量/曝光量 * 100%) |
| 6.4.20 | cpc | CPC - 每次点击成本(广告花费/点击量) | number | 0.38 | 可选 | CPC - 每次点击成本(广告花费/点击量) |
| 6.4.21 | directCvr | directCvr | number | 4.12 | 可选 | CVR - 转化率(广告订单/点击量 * 100%) |
| 6.4.22 | broadCvr | broadCvr | number | 1.41 | 可选 | 间接CVR - 间接转化率(间接订单/点击量 * 100%) |
| 6.4.23 | directCpa | CPA - 每笔订单花费(广告花费/广告订单) | number | 9.16 | 可选 | CPA - 每笔订单花费(广告花费/广告订单) |
| 6.4.24 | broadCpa | broadCpa | number | 26.71 | 可选 | 间接CPA - 每笔间接订单花费(广告花费/间接订单) |
| 6.4.25 | directRoas | directRoas | number | 3.06 | 可选 | 广告ROAS - 广告支出回报率(广告GMV/广告花费) |
| 6.4.26 | broadRoas | broadRoas | number | 0.66 | 可选 | 间接ROAS - 间接广告支出回报率(间接GMV/广告花费) |
| 6.4.27 | directAcos | directAcos | number | 32.68 | 可选 | 广告ACoS - 广告销售成本(广告花费/广告GMV * 100%) |
| 6.4.28 | broadAcos | broadAcos | number | 152.33 | 可选 | 间接ACoS - 间接广告销售成本(广告花费/间接GMV * 100%) |
领星ERP的接口:分页查询店铺报告列表(/basicOpen/multiplatform/ads/shopee/store/report/list),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。