查询店铺趋势

POST

/api/shopee/hot-trend/shop/trend/query

通过店铺ID查询热销店铺的历史趋势数据。入参 shopId 由 queryShopeeShopData、queryShopeeShopRanking、queryShopeeBrandShopList 等接口返回。支持按月（granularity=month）、季度（granularity=quarter）、年（granularity=year）颗粒度统计。支持按类目筛选（categoryId+level）、产品类型筛选（productType）、商品所在地筛选（borderType）。最长可支持查看过去720天。相比 queryShopeeShopTrend（按天返回），该接口支持聚合颗粒度，更适合长期趋势分析。可选站点：tw(台湾)、my(马来西亚)、id(印度尼西亚)、th(泰国)、ph(菲律宾)、sg(新加坡)、vn(越南)、br(巴西)。

请求参数

Body 参数application/json必填

示例

{
    "site": "tw",
    "shopId": 12345678,
    "catId": 100001,
    "level": 1,
    "granularity": 1,
    "startDate": "2025-05-27",
    "endDate": "2026-05-27",
    "pageNo": 1,
    "pageSize": 10
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/api/shopee/hot-trend/shop/trend/query' \
--header 'Content-Type: application/json' \
--data '{
    "site": "tw",
    "shopId": 12345678,
    "catId": 100001,
    "level": 1,
    "granularity": 1,
    "startDate": "2025-05-27",
    "endDate": "2026-05-27",
    "pageNo": 1,
    "pageSize": 10
}'

返回响应

🟢200

*/*

Body*/*

示例

{
    "success": true,
    "errorCode": "string",
    "errorMessage": "string",
    "data": [
        {
            "date": "2026-01",
            "site": "tw",
            "shopId": 12345678,
            "shopName": "Shopee Official Store",
            "shopAddress": "台北市大安区",
            "productTypeName": "虾皮商城",
            "shopTypeName": "本土店铺",
            "itemCount": 500,
            "activeItemCount": 300,
            "activeRate": 60,
            "sales": 10000,
            "gmv": 500000,
            "mainCatName": "Women's Clothing",
            "ratingStar": 4.8,
            "followerCount": 50000,
            "followingCount": 100,
            "ctime": "2020-01-15"
        }
    ],
    "total": 100,
    "pageNo": 1,
    "pageSize": 20
}

修改于 2026-06-12 07:48:11

查询类目趋势概览

查询商品趋势