查询大盘趋势快照

POST

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

用于获取大盘历史趋势快照。按查询账期范围返回，每一个账期显示一条数据；支持天、自然月周期，按更新账期升序或降序分页返回。\n当需要指定数据周期的时候，需要填写不同数据周期对应的周期数据格式,近7天、近28天格式为 yyyy-MM-dd，自然月格式为 yyyy-MM，季度格式为 yyyyQn，年度格式为 yyyy。

请求参数

Authorization

API Key

在 header 添加参数

Authorization

示例：

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

Body 参数application/json必填

示例

{
    "pageNo": 1,
    "pageSize": "15",
    "period": "DAY",
    "startUpdatePeriod": "2026-05-01",
    "endUpdatePeriod": "2026-05-20",
    "sortDirection": "ASC"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/api/v1/categories/market/trends/snapshots/query' \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "pageNo": 1,
    "pageSize": "15",
    "period": "DAY",
    "startUpdatePeriod": "2026-05-01",
    "endUpdatePeriod": "2026-05-20",
    "sortDirection": "ASC"
}'

返回响应

🟢200

application/json

Bodyapplication/json

示例

{
    "success": true,
    "errorCode": "string",
    "errorMessage": "string",
    "data": [
        {
            "categoryId": 17032851,
            "categoryName": "全部类目",
            "updatePeriod": "2026-05-20",
            "salableProductCount": 0,
            "salesRate": "50.00%",
            "gmv": 123.45,
            "gmvGrowthRate": "50.00%",
            "sales": 0,
            "salesGrowthRate": "50.00%"
        }
    ],
    "total": 100,
    "pageNo": 1,
    "pageSize": 20
}

🟠400

🟠401

🟠403

🔴500

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

查询公共三级类目

查询类目趋势快照