查询类目趋势快照

POST

/api/v1/categories/trends/snapshots/query

通过类目ID、类目类型ID、数据周期和账期范围查询类目历史趋势快照数据。\n当需要指定数据周期的时候，需要填写不同数据周期对应的周期数据格式,近7天、近28天格式为 yyyy-MM-dd，自然月格式为 yyyy-MM，季度格式为 yyyyQn，年度格式为 yyyy。

请求参数

Authorization

API Key

在 header 添加参数

Authorization

示例：

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

Body 参数application/json必填

示例

{
    "categories": [
        {
            "categoryId": 17032851,
            "typeId": 99395
        }
    ],
    "categoryId": 17032851,
    "typeId": 99395,
    "language": "CH",
    "period": "SEVEN_DAY",
    "startPeriod": "2026-05-01",
    "endPeriod": "2026-05-20",
    "sortDirection": "ASC"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/api/v1/categories/trends/snapshots/query' \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "categories": [
        {
            "categoryId": 17032851,
            "typeId": 99395
        }
    ],
    "categoryId": 17032851,
    "typeId": 99395,
    "language": "CH",
    "period": "SEVEN_DAY",
    "startPeriod": "2026-05-01",
    "endPeriod": "2026-05-20",
    "sortDirection": "ASC"
}'

返回响应

🟢200

application/json

Bodyapplication/json

示例

{
    "success": true,
    "errorCode": "string",
    "errorMessage": "string",
    "data": [
        {
            "category": {
                "categoryId": 0,
                "level1CategoryId": 0,
                "level2CategoryId": 0,
                "level3CategoryId": 0,
                "typeId": 0,
                "categoryNameCn": "string",
                "categoryNameRu": "string"
            },
            "updatePeriod": "2026-05-20",
            "currentDaySales": 123.45,
            "currentDaySalesGrowthRate": "50.00%",
            "currentDayGmv": 123.45,
            "currentDayGmvGrowthRate": "50.00%",
            "currentDayPrice": 123.45,
            "sales": 123.45,
            "salesGrowthRate": "50.00%",
            "gmv": 123.45,
            "gmvGrowthRate": "50.00%",
            "salableProductCount": 0,
            "salesRate": "50.00%",
            "topSalesDynamics": "50.00%"
        }
    ]
}

🟠400

🟠401

🟠403

🔴500

修改于 2026-06-10 10:38:06

查询大盘趋势快照

查询类目热销榜单