查询站点类目列表

POST

/api/shopee/cat/data/query

查询某个站点的同一个级别下多个类目的基础数据。返回该类目级别下所有类目的销量、销售额、商品数等汇总指标。入参 level=1 查询一级类目，level=2 查询二级类目，level=3 查询三级类目。如果 level 不传则默认查一级类目。获取到类目ID后，可进一步调用：

queryShopeeSubCatData：查看某个类目的子类目列表

queryShopeeCatTrend：查看该类目历史趋势

queryShopeeCatRanking：查看该类目榜单

queryShopeeCatPriceDistribute：查看该类目价格分布

queryShopeeItemData：查看该类目下商品列表

queryShopeeBrandData：查看该类目下品牌列表
可选站点：tw(台湾)、my(马来西亚)、id(印度尼西亚)、th(泰国)、ph(菲律宾)、sg(新加坡)、vn(越南)、br(巴西)。

请求参数

Authorization

API Key

在 header 添加参数

Authorization

示例：

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

Body 参数application/json必填

示例

{
    "pageNo": 1,
    "pageSize": 20,
    "site": "tw",
    "level": 1,
    "timest": "2026-05-26"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/api/shopee/cat/data/query' \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "pageNo": 1,
    "pageSize": 20,
    "site": "tw",
    "level": 1,
    "timest": "2026-05-26"
}'

返回响应

🟢200

*/*

Body*/*

示例

{
    "success": true,
    "errorCode": "string",
    "errorMessage": "string",
    "data": [
        {
            "date": "2026-05-26",
            "site": "tw",
            "categoryId": 100001,
            "categoryName": "Bookings & Vouchers",
            "categoryLevel": 1,
            "parentLevel": 1,
            "itemCount": 50000,
            "activeItemCount": 30000,
            "sales": 100000,
            "sales7day": 700000,
            "sales30day": 3000000,
            "gmv": 5000000,
            "gmv7day": 35000000,
            "gmv30day": 150000000,
            "shopCount": 2000,
            "activeShopCount": 1500,
            "avgPrice": 150
        }
    ],
    "total": 100,
    "pageNo": 1,
    "pageSize": 20
}

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

查询类目价格分布

查询品牌趋势快照