Lingxing
切换旧版

分页查询店铺报告列表

接口信息

API Path请求协议请求方式令牌桶容量
/basicOpen/multiplatform/ads/shopee/store/report/listHTTPSPOST ss1

请求参数

pageobject必填
分页参数对象
隐藏子属性
pagenumber必填
当前页码，从 1 开始
示例 1
lengthnumber必填
每页大小
示例 20
orderFieldstring必填
排序字段，按返回字段名称排序
示例 cost
orderTypestring必填
排序类型：
asc 升序
desc 降序
示例 desc
periodobject必填
时间范围对象
示例 {"startDate":"2026-03-01","endDate":"2026-03-17"}
隐藏子属性
startDatestring必填
开始日期，格式：yyyy-MM-dd
示例 2026-03-01
endDatestring必填
结束日期，格式：yyyy-MM-dd
示例 2026-03-17
filterobject
筛选条件对象
示例 {"shopIds":[10001,10002],"isSyncList":[1]}
隐藏子属性
shopIdsarray<any>
店铺ID列表（复选，为空则代表全部）
示例 [10001,10002]
isSyncListarray<any>
店铺同步状态列表（复选，为空时为全部）：
0 停用
1 启用
示例 [1]

请求cURL示例

curl --location 'https://openapi.lingxing.com/basicOpen/multiplatform/ads/shopee/store/report/list?access_token=value&timestamp=value&sign=value&app_key=value' \
--header 'Content-Type: application/json' \
--data '{
    "page": {
        "page": 1,
        "length": 20,
        "orderField": "cost",
        "orderType": "desc"
    },
    "period": {
        "startDate": "2026-03-01",
        "endDate": "2026-03-17"
    },
    "filter": {
        "shopIds": [10001,10002],
        "isSyncList": [1]
    }
}'

返回结果

JSON Object

codenumber必填
状态码，0：成功
示例 0
messagestring必填
消息提示
示例 success
error_detailsarray<any>必填
数据校验失败时的错误详情
示例 []
request_idstring必填
请求链路id
示例 ccafcc7d9a72484fac5a3889b5db2986.231.17611516492143035
response_timestring必填
响应时间
示例 2025-10-23 00:47:29
dataobject必填
响应数据
隐藏子属性
totalnumber必填
总记录数
示例 128
pagenumber必填
当前页码
示例 1
lengthnumber必填
每页大小
示例 20
listarray<object>必填
数据列表
隐藏子属性
dimensionstring
唯一标识，数据行为店铺ID的字符串形式
示例 10001
currencyCodestring
币种代码
示例 USD
storeIdnumber
店铺ID
示例 10001
storeNamestring
店铺名称
示例 Shopee SG Store
shopIdnumber
Shopee 店铺ID
示例 900001
lxNamestring
店铺展示名称
示例 Shopee-SG-001
isSyncnumber
同步状态：
0 停用
1 启用
示例 1
isSyncDisplayNamestring
同步状态显示名称（国际化）
示例 启用
impressionnumber
曝光量
示例 15000
clicksnumber
点击量
示例 850
costnumber
广告花费
示例 320.5
directOrdernumber
广告订单（直接订单）
示例 35
broadOrdernumber
间接订单
示例 12
directItemSoldnumber
广告销量（直接售出商品数）
示例 42
broadItemSoldnumber
间接销量（间接售出商品数）
示例 16
directGmvnumber
广告GMV（直接GMV）
示例 980.6
broadGmvnumber
间接GMV
示例 210.4
clickPercentnumber
点击百分比（点击量占查询结果总点击量的百分比）
示例 12.36
ctrnumber
CTR - 点击率（点击量/曝光量 * 100%）
示例 5.67
cpcnumber
CPC - 每次点击成本（广告花费/点击量）
示例 0.38
directCvrnumber
CVR - 转化率（广告订单/点击量 * 100%）
示例 4.12
broadCvrnumber
间接CVR - 间接转化率（间接订单/点击量 * 100%）
示例 1.41
directCpanumber
CPA - 每笔订单花费（广告花费/广告订单）
示例 9.16
broadCpanumber
间接CPA - 每笔间接订单花费（广告花费/间接订单）
示例 26.71
directRoasnumber
广告ROAS - 广告支出回报率（广告GMV/广告花费）
示例 3.06
broadRoasnumber
间接ROAS - 间接广告支出回报率（间接GMV/广告花费）
示例 0.66
directAcosnumber
广告ACoS - 广告销售成本（广告花费/广告GMV * 100%）
示例 32.68
broadAcosnumber
间接ACoS - 间接广告销售成本（广告花费/间接GMV * 100%）
示例 152.33

返回成功示例

{
    "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
            }
        ]
    }
}