查询店铺榜单

POST

/api/shopee/shop/ranking/query

提供店铺热销榜和飙升榜查询。支持按类目（categoryId+level）、产品类型（shopType）、店铺类型（borderType）筛选。热销榜（sortField=1）按周期销量降序排序，飙升榜（sortField=2）按周期销量增长率降序排序。支持天榜（period=1）、周榜（period=2）、月榜（period=3）三种周期。入参 categoryId 和 level 由类目查询接口返回。返回的店铺ID（shop_id）可作为入参传递给店铺分析和商品查询接口。可选站点：tw(台湾)、my(马来西亚)、id(印度尼西亚)、th(泰国)、ph(菲律宾)、sg(新加坡)、vn(越南)、br(巴西)。

请求参数

Body 参数application/json必填

示例

{
    "site": "tw",
    "level": 1,
    "categoryId": 100001,
    "date": "2026-05-26",
    "shopType": 0,
    "borderType": 0,
    "sortField": 1,
    "period": 3,
    "pageNo": 1,
    "pageSize": 10
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/api/shopee/shop/ranking/query' \
--header 'Content-Type: application/json' \
--data '{
    "site": "tw",
    "level": 1,
    "categoryId": 100001,
    "date": "2026-05-26",
    "shopType": 0,
    "borderType": 0,
    "sortField": 1,
    "period": 3,
    "pageNo": 1,
    "pageSize": 10
}'

返回响应

🟢200

*/*

Body*/*

示例

{
    "success": true,
    "errorCode": "string",
    "errorMessage": "string",
    "data": [
        null
    ],
    "total": 100,
    "pageNo": 1,
    "pageSize": 20
}

修改于 2026-06-10 11:03:26

查询店铺趋势快照

查询店铺销量价格分布