查询产品趋势快照

POST

/api/v1/products/trends/snapshots/query

按单个商品ID查询历史趋势快照，每个更新账期返回一条数据，含评分、评论数、价格、当天销量与销售额；缺天补零。 startUpdatePeriod/endUpdatePeriod 为 yyyy-MM-dd，不传默认近30天，最多90天。发货模式默认 FBO；仓库类型默认 ALL；默认按更新账期升序；一次返回区间内全部账期，不分页。

请求参数

Authorization

API Key

在 header 添加参数

Authorization

示例：

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

Body 参数application/json必填

示例

{
    "itemId": 123456789,
    "startUpdatePeriod": "2026-04-22",
    "endUpdatePeriod": "2026-05-21",
    "deliveryMode": "ALL",
    "storeType": "ALL",
    "sortField": "UPDATE_PERIOD",
    "sortDirection": "ASC"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/api/v1/products/trends/snapshots/query' \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "itemId": 123456789,
    "startUpdatePeriod": "2026-04-22",
    "endUpdatePeriod": "2026-05-21",
    "deliveryMode": "ALL",
    "storeType": "ALL",
    "sortField": "UPDATE_PERIOD",
    "sortDirection": "ASC"
}'

返回响应

🟢200

application/json

Bodyapplication/json

示例

{
    "success": true,
    "errorCode": "string",
    "errorMessage": "string",
    "data": [
        {
            "updatePeriod": "2026-05-20",
            "itemId": 0,
            "itemName": "string",
            "itemRating": 123.45,
            "itemFeedbacks": 0,
            "price": 123.45,
            "sales": 0,
            "gmv": 123.45
        }
    ]
}

🟠400

🟠401

🟠403

🔴500

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

查询产品SKU变体分析

查询产品关键词分析