查询热销产品列表

POST

/api/v1/products/rankings/hot/query

查询热销产品销售数据，支持按类目、数据周期、更新账期、销量/销售额/价格范围、创建日期、发货模式、跨境禁售权限、产品类型、销售水平和排序分页查询。

请求参数

Authorization

API Key

在 header 添加参数

Authorization

示例：

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

Body 参数application/json必填

示例

{
    "pageNo": 1,
    "pageSize": 15,
    "level1CategoryId": 17027489,
    "level2CategoryId": 17027500,
    "level3CategoryId": 17032851,
    "typeId": 99395,
    "period": "SEVEN_DAY",
    "updatePeriod": "2026-05-20",
    "minSales": 0,
    "maxSales": 0,
    "minGmv": 0,
    "maxGmv": 0,
    "minPrice": 0,
    "maxPrice": 0,
    "minCreateDate": "string",
    "maxCreateDate": "string",
    "deliveryModes": [
        "string"
    ],
    "crossBorderSalePermission": 0,
    "productType": 0,
    "salesLevel": 0,
    "sortField": "SALES",
    "sortDirection": "ASC"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/api/v1/products/rankings/hot/query' \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "pageNo": 1,
    "pageSize": 15,
    "level1CategoryId": 17027489,
    "level2CategoryId": 17027500,
    "level3CategoryId": 17032851,
    "typeId": 99395,
    "period": "SEVEN_DAY",
    "updatePeriod": "2026-05-20",
    "minSales": 0,
    "maxSales": 0,
    "minGmv": 0,
    "maxGmv": 0,
    "minPrice": 0,
    "maxPrice": 0,
    "minCreateDate": "string",
    "maxCreateDate": "string",
    "deliveryModes": [
        "string"
    ],
    "crossBorderSalePermission": 0,
    "productType": 0,
    "salesLevel": 0,
    "sortField": "SALES",
    "sortDirection": "ASC"
}'

返回响应

🟢200

application/json

Bodyapplication/json

示例

{
    "success": true,
    "errorCode": "string",
    "errorMessage": "string",
    "data": [
        {
            "shopId": 2791298,
            "shopName": "Сима-Ленд - Маркет",
            "updatePeriod": "2026-05-20",
            "itemTitle": "string",
            "itemId": 0,
            "category": {
                "categoryId": 0,
                "level1CategoryId": 0,
                "level2CategoryId": 0,
                "level3CategoryId": 0,
                "typeId": 0,
                "categoryNameCn": "string",
                "categoryNameRu": "string"
            },
            "brand": "string",
            "sales": 0,
            "salesDynamics": "50.00%",
            "gmv": 123.45,
            "cartRatio": "50.00%",
            "exposureCount": 0,
            "browseCount": 0,
            "clickRatio": "50.00%",
            "redemptionSales": 123.45,
            "redemptionRate": "50.00%",
            "adSales": 123.45,
            "adRate": "50.00%",
            "orderConversionRate": "50.00%",
            "averagePrice": 123.45,
            "grossProfitRate": "50.00%",
            "deliveryMode": "string",
            "deliveryTime": 0,
            "createDate": "string",
            "searchCartRatio": "50.00%",
            "usability": "50.00%",
            "averageSales": 123.45,
            "averageGmv": 123.45,
            "outOfStockDayRate": "50.00%",
            "stock": 0,
            "volume": 123.45,
            "length": 123.45,
            "width": 123.45,
            "height": 123.45,
            "weight": 123.45
        }
    ],
    "total": 100,
    "pageNo": 1,
    "pageSize": 20
}

🟠400

🟠401

🟠403

🔴500

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

查询店铺趋势快照

查询中国专区产品列表