查询店铺类目分布

POST

/api/shopee/shop/cat/distribute/query

通过店铺ID查询知虾已收录该店铺的热销商品的所属类目分布。入参 shopId 由 queryShopeeShopData、queryShopeeShopRanking 等接口返回。若不传 categoryId 则查询该店铺全部一级类目数据。若传了 categoryId 则查询该类目下的全部子类目数据。适用于分析店铺主要经营哪些类目、每个类目的销量占比。可选站点：tw(台湾)、my(马来西亚)、id(印度尼西亚)、th(泰国)、ph(菲律宾)、sg(新加坡)、vn(越南)、br(巴西)。

请求参数

Body 参数application/json必填

示例

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

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/api/shopee/shop/cat/distribute/query' \
--header 'Content-Type: application/json' \
--data '{
    "site": "tw",
    "shopId": 12345678,
    "timest": "2026-05-26",
    "categoryId": 100001,
    "level": 1,
    "pageNo": 1,
    "pageSize": 20
}'

返回响应

🟢200

*/*

Body*/*

示例

{
    "success": true,
    "errorCode": "string",
    "errorMessage": "string",
    "data": [
        {
            "date": "2026-05-26",
            "site": "tw",
            "categoryName": "Women's Clothing",
            "catId": 100001,
            "itemCount": 500,
            "itemRatio": 25.5,
            "avgPrice": 150,
            "sales": 1000,
            "sales30day": 30000,
            "gmv30day": 4500000,
            "totalSales": 500000,
            "totalGmv": 75000000,
            "totalComment": 10000,
            "totalLike": 5000
        }
    ],
    "total": 100,
    "pageNo": 1,
    "pageSize": 20
}

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

查询店铺列表数据

查询店铺品牌分析