热搜词趋势快照

POST

/api/shopee/word/trend/query

通过热搜词ID查询热搜词历史趋势快照，最多支持过去30天。入参 wordId 由 queryShopeeWordData、queryShopeeWordRanking 等接口返回。支持模糊搜索（isFuzzy=true：查找相似词名的聚合趋势）和精准搜索（isFuzzy=false：单个词的精确趋势）。返回该热搜词每天的销量、销售额、搜索指数等指标。可选站点：tw(台湾)、my(马来西亚)、id(印度尼西亚)、th(泰国)、ph(菲律宾)、sg(新加坡)、vn(越南)、br(巴西)。

请求参数

Body 参数application/json必填

示例

{
    "site": "tw",
    "hotWordId": 123456,
    "startDate": "2026-04-26",
    "endDate": "2026-05-26",
    "pageNo": 1,
    "pageSize": 10
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/api/shopee/word/trend/query' \
--header 'Content-Type: application/json' \
--data '{
    "site": "tw",
    "hotWordId": 123456,
    "startDate": "2026-04-26",
    "endDate": "2026-05-26",
    "pageNo": 1,
    "pageSize": 10
}'

返回响应

🟢200

*/*

Body*/*

示例

{
    "success": true,
    "errorCode": "string",
    "errorMessage": "string",
    "data": [
        {
            "site": "tw",
            "hotWordId": 123123,
            "word": "连衣裙",
            "transCn": "连衣裙",
            "transEn": "Dress",
            "catId": 2932,
            "catName": "Women's Clothing",
            "itemCount": 12000,
            "activeItemCount": 8500,
            "dailyActiveRate": 70.83,
            "sales": 5000,
            "sales30day": 150000,
            "sales30dayGrowthRate": 15.5,
            "gmv": 500000,
            "gmv30day": 15000000,
            "itemAveragePrice": 120,
            "recPrice": 3.5,
            "searchIndex": 85000,
            "likeCount": 50000,
            "ratingNum": 10000,
            "timest": "2026-05-26"
        }
    ],
    "total": 100,
    "pageNo": 1,
    "pageSize": 20
}

修改于 2026-06-10 11:03:26

查询关键词关联商品

查询热搜词榜单