查询品牌产品

POST

/api/v1/brands/products/query

按单个品牌名称分页查询该品牌下热门商品销售数据，含主图、评分、评论、类目路径、店铺、价格与销售额（卢布及按系统汇率折算的人民币）、日均/月销量、发货模式、库存及上架日期。 updatePeriod 为 yyyy-MM-dd，不传取最新账期；默认按日销量降序，pageSize 最大 15。

请求参数

Authorization

API Key

在 header 添加参数

Authorization

示例：

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

Body 参数application/json必填

示例

{
    "pageNo": 1,
    "pageSize": 15,
    "brandName": "Nike",
    "updatePeriod": "2026-08-20"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/api/v1/brands/products/query' \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "pageNo": 1,
    "pageSize": 15,
    "brandName": "Nike",
    "updatePeriod": "2026-08-20"
}'

返回响应

🟢200

application/json

Bodyapplication/json

示例

{
    "success": true,
    "errorCode": "string",
    "errorMessage": "string",
    "data": [
        {
            "brandName": "string",
            "itemId": 0,
            "itemName": "string",
            "itemPhoto": "string",
            "itemRating": 123.45,
            "itemFeedbacks": 0,
            "skuCount": 0,
            "categoryPathZh": "string",
            "categoryPathRu": "string",
            "shopName": "string",
            "shopId": 0,
            "productType": "string",
            "price": 123.45,
            "priceCny": 123.45,
            "avgSales": 0,
            "avgSalesDynamics": "50.00%",
            "avgGmv": 123.45,
            "avgGmvCny": 123.45,
            "monthSales": 0,
            "monthSalesDynamics": "50.00%",
            "monthGmv": 123.45,
            "monthGmvCny": 123.45,
            "deliveryModes": [
                "ALL"
            ],
            "stock": 0,
            "launchDate": "string",
            "updatePeriod": "string"
        }
    ],
    "total": 100,
    "pageNo": 1,
    "pageSize": 20
}

🟠400

🟠401

🟠403

🔴500

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

查询关键词详情

查询品牌列表