商品热搜词分析

POST

/api/shopee/item/hotword/query

通过商品ID获取商品最近30天的引流词数据以及推荐同类目热词。入参 itemIds 由 queryShopeeItemData、queryShopeeItemRanking、queryShopeeShopItemList 等接口返回。type=1：查询该商品关联的引流词（搜索该词进入商品页面的关键词）。type=2：推荐同类目热词（该商品最小子类目下近30天销量TOP100商品的引流词）。单次最多可传10个商品ID，多个使用英文逗号分隔。可选站点：tw(台湾)、my(马来西亚)、id(印度尼西亚)、th(泰国)、ph(菲律宾)、sg(新加坡)、vn(越南)、br(巴西)。

请求参数

Authorization

API Key

在 header 添加参数

Authorization

示例：

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

Body 参数application/json必填

示例

{
    "site": "tw",
    "itemIds": "1234567890,1234567891",
    "type": 1,
    "timest": "2026-05-26"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/api/shopee/item/hotword/query' \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "site": "tw",
    "itemIds": "1234567890,1234567891",
    "type": 1,
    "timest": "2026-05-26"
}'

返回响应

🟢200

*/*

Body*/*

示例

{
    "success": true,
    "errorCode": "string",
    "errorMessage": "string",
    "data": [
        {
            "timest": "2026-05-26",
            "site": "tw",
            "hotWordName": "连衣裙",
            "itemCount": 1200,
            "sales30day": 50000,
            "gmv30day": 1500000,
            "recPrice": 3.5,
            "searchIndex": 85000
        }
    ]
}

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

查询商品榜单

批量获取商品详情