查询产品详情

POST

/api/v1/products/detail/query

按商品ID批量查询热门产品基础销售信息，含品牌、主图、评分、评论、类目路径、店铺、价格、日均/月销量与销售额、发货模式、库存及上架日期。商品ID最多可传10个，多个使用英文逗号分隔；updatePeriod 为 yyyy-MM-dd，不传取最新账期；默认按销售额降序。

请求参数

Authorization

API Key

在 header 添加参数

Authorization

示例：

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

Body 参数application/json必填

示例

{
    "itemIds": "123456789,987654321",
    "updatePeriod": "2026-05-20",
    "sortField": "SALES",
    "sortDirection": "ASC"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/api/v1/products/detail/query' \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "itemIds": "123456789,987654321",
    "updatePeriod": "2026-05-20",
    "sortField": "SALES",
    "sortDirection": "ASC"
}'

返回响应

🟢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,
            "avgSales": 0,
            "avgSalesDynamics": "50.00%",
            "avgGmv": 123.45,
            "monthSales": 0,
            "monthSalesDynamics": "50.00%",
            "monthGmv": 123.45,
            "deliveryModes": [
                "ALL"
            ],
            "stock": 0,
            "launchDate": "string",
            "updatePeriod": "string"
        }
    ]
}

🟠400

🟠401

🟠403

🔴500

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

查询热销产品列表

查询关键词趋势快照