查询店铺热销榜单

POST

/api/v1/shops/rankings/hot/query

按账期、类目、店铺、店铺级别、店铺类型和区间条件查询热销店铺列表。

请求参数

Authorization

API Key

在 header 添加参数

Authorization

示例：

Authorization: ********************

Body 参数application/json必填

示例

{
    "pageNo": 1,
    "pageSize": 15,
    "updatePeriod": "2026-05-20",
    "categoryId": 17032851,
    "categoryLevel": 3,
    "typeId": 99395,
    "shopKeyword": 2791298,
    "minProductCount": 0,
    "maxProductCount": 0,
    "minSalableProductCount": 0,
    "maxSalableProductCount": 0,
    "minShopRating": 0,
    "maxShopRating": 0,
    "minSalesRate": 0,
    "maxSalesRate": 0,
    "minSales": 0,
    "maxSales": 0,
    "minGmv": 0,
    "maxGmv": 0,
    "shopLevel": 0,
    "openTimeRange": 0,
    "shopArea": 2
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/api/v1/shops/rankings/hot/query' \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "pageNo": 1,
    "pageSize": 15,
    "updatePeriod": "2026-05-20",
    "categoryId": 17032851,
    "categoryLevel": 3,
    "typeId": 99395,
    "shopKeyword": 2791298,
    "minProductCount": 0,
    "maxProductCount": 0,
    "minSalableProductCount": 0,
    "maxSalableProductCount": 0,
    "minShopRating": 0,
    "maxShopRating": 0,
    "minSalesRate": 0,
    "maxSalesRate": 0,
    "minSales": 0,
    "maxSales": 0,
    "minGmv": 0,
    "maxGmv": 0,
    "shopLevel": 0,
    "openTimeRange": 0,
    "shopArea": 2
}'

返回响应

🟢200

application/json

Bodyapplication/json

示例

{
    "success": true,
    "errorCode": "string",
    "errorMessage": "string",
    "data": [
        {
            "shopId": 2791298,
            "shopName": "Сима-Ленд - Маркет",
            "updatePeriod": "2026-05-20",
            "shopLevel": "string",
            "shopArea": "string",
            "shopRating": 123.45,
            "company": "ООО СИМА-МАРКЕТ",
            "shopAddress": "string",
            "shopCoverImage": "string",
            "mainCategory": {
                "categoryId": 0,
                "level1CategoryId": 0,
                "level2CategoryId": 0,
                "level3CategoryId": 0,
                "typeId": 0,
                "categoryNameCn": "string",
                "categoryNameRu": "string"
            },
            "openPeriod": "1年3个月",
            "statisticCategory": {
                "categoryId": 0,
                "level1CategoryId": 0,
                "level2CategoryId": 0,
                "level3CategoryId": 0,
                "typeId": 0,
                "categoryNameCn": "string",
                "categoryNameRu": "string"
            },
            "sales": 0,
            "gmv": 123.45,
            "productCount": 0,
            "salableProductCount": 0,
            "salesRate": "50.00%",
            "top10AveragePrice": 123.45,
            "top10ProductGmv": 123.45,
            "top10BrandGmvRate": "50.00%"
        }
    ],
    "total": 100,
    "pageNo": 1,
    "pageSize": 20
}

🟠400

🟠401

🟠403

🔴500

修改于 2026-06-10 10:38:06

查询类目详情

查询店铺详情