查询品牌列表

POST

/api/v1/brands/list/query

按账期、一级/二级类目、品牌名称、发货模式及产品数/动销率/卖家数/销量/销售额等区间分页查询 Wildberries 品牌 Top 榜销售数据。 updatePeriod 为 yyyy-MM-dd，不传取最新账期。一/二级类目同时传入时按二级查询；都不传查全部。发货模式默认 ALL；品牌名称默认模糊搜索；默认按销售额降序，pageSize 最大 15。

请求参数

Authorization

API Key

在 header 添加参数

Authorization

示例：

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

Body 参数application/json必填

示例

{
    "pageNo": 1,
    "pageSize": 15,
    "updatePeriod": "2026-08-20",
    "level1CategoryId": 12345,
    "categoryId": 67890,
    "brandName": "Nike",
    "brandSearchType": "FUZZY",
    "minItemNum": 0,
    "maxItemNum": 0,
    "minSalesRatio": 0,
    "maxSalesRatio": 0,
    "minShopNum": 0,
    "maxShopNum": 0,
    "minTopSalesItemRatio": 0,
    "maxTopSalesItemRatio": 0,
    "minSales": 0,
    "maxSales": 0,
    "minGmv": 0,
    "maxGmv": 0,
    "minTop10GmvRatio": 0,
    "maxTop10GmvRatio": 0,
    "minTop10AvgPrice": 0,
    "maxTop10AvgPrice": 0,
    "deliveryMode": "ALL",
    "sortField": "SALES",
    "sortDirection": "ASC"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/api/v1/brands/list/query' \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "pageNo": 1,
    "pageSize": 15,
    "updatePeriod": "2026-08-20",
    "level1CategoryId": 12345,
    "categoryId": 67890,
    "brandName": "Nike",
    "brandSearchType": "FUZZY",
    "minItemNum": 0,
    "maxItemNum": 0,
    "minSalesRatio": 0,
    "maxSalesRatio": 0,
    "minShopNum": 0,
    "maxShopNum": 0,
    "minTopSalesItemRatio": 0,
    "maxTopSalesItemRatio": 0,
    "minSales": 0,
    "maxSales": 0,
    "minGmv": 0,
    "maxGmv": 0,
    "minTop10GmvRatio": 0,
    "maxTop10GmvRatio": 0,
    "minTop10AvgPrice": 0,
    "maxTop10AvgPrice": 0,
    "deliveryMode": "ALL",
    "sortField": "SALES",
    "sortDirection": "ASC"
}'

返回响应

🟢200

application/json

Bodyapplication/json

示例

{
    "success": true,
    "errorCode": "string",
    "errorMessage": "string",
    "data": [
        {
            "brandName": "Nike",
            "itemNum": 0,
            "salesItemNum": 0,
            "salesRatio": "50.00%",
            "shopNum": 0,
            "sales": 0,
            "avgSales": 0,
            "gmv": 123.45,
            "avgGmv": 123.45,
            "topSalesItemNum": 0,
            "topSalesItemRatio": "50.00%",
            "top10Gmv": 123.45,
            "top10GmvRatio": "50.00%",
            "top10AvgPrice": 123.45,
            "updatePeriod": "string"
        }
    ],
    "total": 100,
    "pageNo": 1,
    "pageSize": 20
}

🟠400

🟠401

🟠403

🔴500

修改于 2026-09-04 07:45:16

查询品牌产品

查询品牌详情