查询品牌Top榜销售数据

POST

/api/v1/brands/rankings/top/query

按一级、二级、三级类目、品牌名称、更新账期、销量/销售额/价格排序和分页查询品牌Top榜销售数据。

请求参数

Authorization

API Key

在 header 添加参数

Authorization

示例：

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

Body 参数application/json必填

示例

{
    "pageNo": 1,
    "pageSize": 15,
    "level1CategoryId": 17027489,
    "level2CategoryId": 17027500,
    "level3CategoryId": 17032851,
    "typeId": 99395,
    "brandName": "Xiaomi",
    "brandSearchType": "FUZZY",
    "updatePeriod": "2026-05-20",
    "sortField": "SALES",
    "sortDirection": "ASC"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/api/v1/brands/rankings/top/query' \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "pageNo": 1,
    "pageSize": 15,
    "level1CategoryId": 17027489,
    "level2CategoryId": 17027500,
    "level3CategoryId": 17032851,
    "typeId": 99395,
    "brandName": "Xiaomi",
    "brandSearchType": "FUZZY",
    "updatePeriod": "2026-05-20",
    "sortField": "SALES",
    "sortDirection": "ASC"
}'

返回响应

🟢200

application/json

Bodyapplication/json

示例

{
    "success": true,
    "errorCode": "string",
    "errorMessage": "string",
    "data": [
        {
            "brandName": "string",
            "category": {
                "categoryId": 0,
                "level1CategoryId": 0,
                "level2CategoryId": 0,
                "level3CategoryId": 0,
                "typeId": 0,
                "categoryNameCn": "string",
                "categoryNameRu": "string"
            },
            "updatePeriod": "2026-05-20",
            "monthSales": 0,
            "monthGmv": 123.45,
            "top5BrandGmvRate": "50.00%",
            "brandGmvRate": "50.00%",
            "top10ProductGmv": 123.45,
            "top10ProductGmvRate": "50.00%",
            "top10AveragePrice": 123.45
        }
    ],
    "total": 100,
    "pageNo": 1,
    "pageSize": 20
}

🟠400

🟠401

🟠403

🔴500

修改于 2026-06-13 06:49:34

查询产品信息追踪

查询品牌商品销售数据