查询类目价格分布

POST

/api/shopee/cat/price/distribute/query

通过类目ID查询某个站点下的最小类目的价格分布区间数据。入参 categoryId 由 queryShopeeCatData 或 queryShopeeSubCatData 返回。level 必须为 2 或 3（仅支持二级和三级类目）。返回不同价格区间的销量、销售额、商品数及占比，适用于分析类目主流价格带。可选站点：tw(台湾)、my(马来西亚)、id(印度尼西亚)、th(泰国)、ph(菲律宾)、sg(新加坡)、vn(越南)、br(巴西)。

请求参数

Authorization

API Key

在 header 添加参数

Authorization

示例：

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

Body 参数application/json必填

示例

{
    "site": "tw",
    "level": 2,
    "categoryId": 100001,
    "timest": "2026-05-26"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/api/shopee/cat/price/distribute/query' \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "site": "tw",
    "level": 2,
    "categoryId": 100001,
    "timest": "2026-05-26"
}'

返回响应

🟢200

*/*

Body*/*

示例

{
    "success": true,
    "errorCode": "string",
    "errorMessage": "string",
    "data": [
        {
            "date": "2026-05-26",
            "priceRange": "0-50",
            "sales7day": 50000,
            "sales7dayRatio": 25,
            "activeItemCount": 3000,
            "activeItemRatio": 30,
            "avgSales": 16.67
        }
    ]
}

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

查询类目榜单数据

查询站点类目列表