查询类目趋势概览

POST

/api/shopee/hot-trend/category/trend/query

通过类目ID查询该类目的历史趋势概览数据。入参 categoryId 和 level 由类目查询接口（queryShopeeCatData 或 queryShopeeLevel1/2/3Categories）返回。支持按月（granularity=month）、季度（granularity=quarter）、年（granularity=year）颗粒度统计。支持多站点同时查询（sites 参数传入多个站点编码）。支持产品类型筛选（productType）和商品所在地筛选（borderType）。相比 queryShopeeCatTrend（按天返回），该接口数据经过聚合，更适合长期趋势分析。

请求参数

Authorization

API Key

在 header 添加参数

Authorization

示例：

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

Body 参数application/json必填

示例

{
    "sites": [
        "tw",
        "my"
    ],
    "level": 1,
    "catId": 100001,
    "granularity": 1,
    "startDate": "2026-01-01",
    "endDate": "2026-06-26",
    "productType": 0,
    "location": 0
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/api/shopee/hot-trend/category/trend/query' \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "sites": [
        "tw",
        "my"
    ],
    "level": 1,
    "catId": 100001,
    "granularity": 1,
    "startDate": "2026-01-01",
    "endDate": "2026-06-26",
    "productType": 0,
    "location": 0
}'

返回响应

🟢200

*/*

Body*/*

示例

{
    "success": true,
    "errorCode": "string",
    "errorMessage": "string",
    "data": [
        {
            "date": "2026-01",
            "site": "tw",
            "catId": 100001,
            "catName": "Women's Clothing",
            "level": 1,
            "itemCount": 50000,
            "activeItemCount": 30000,
            "sales": 1000000,
            "gmv": 50000000,
            "brandCount": 500,
            "shopCount": 2000,
            "activeShopCount": 1500
        }
    ]
}

修改于 2026-06-09 10:18:34

查询商品趋势

查询品牌趋势