查询商品趋势快照

POST

/api/shopee/item/trend/query

通过商品ID查询商品历史趋势快照。入参 itemId 由 queryShopeeItemData、queryShopeeItemRanking、queryShopeeShopItemList、queryShopeeWordItemList 等接口返回。按天返回商品的价格、销量、GMV、评分、点赞数、评论数等指标。适用于分析某个商品历史销量趋势场景，最长支持过去720天。如需更精细的颗粒度趋势分析（按月/季度/年聚合），可改用 queryShopeeItemTrendDetail。可选站点：tw(台湾)、my(马来西亚)、id(印度尼西亚)、th(泰国)、ph(菲律宾)、sg(新加坡)、vn(越南)、br(巴西)。

请求参数

Authorization

API Key

在 header 添加参数

Authorization

示例：

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

Body 参数application/json必填

示例

{
    "site": "tw",
    "itemId": 1234567890,
    "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/item/trend/query' \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "site": "tw",
    "itemId": 1234567890,
    "startDate": "2025-05-27",
    "endDate": "2026-05-27",
    "pageNo": 1,
    "pageSize": 10
}'

返回响应

🟢200

*/*

Body*/*

示例

{
    "success": true,
    "errorCode": "string",
    "errorMessage": "string",
    "data": [
        {
            "site": "tw",
            "itemName": "2026新款夏季连衣裙",
            "itemId": 1234567890,
            "ctime": "2025-01-01",
            "price": 199,
            "sales": 500,
            "gmv": 50000,
            "totalSales": 500000,
            "ratingStar": 4.8,
            "likeCount": 5000,
            "commentCount": 10000,
            "timest": "2026-05-26"
        }
    ],
    "total": 100,
    "pageNo": 1,
    "pageSize": 20
}

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

查询店铺品牌分析

查询商品榜单