查询 Shopee 一级类目

POST

/api/shopee/categories/level1/query

按站点和语言查询 Shopee 一级类目数据，返回该类目ID和名称。返回的类目ID可作为入参传递给 queryShopeeLevel2Categories 的 level1CategoryId 字段。所有商品/店铺/品牌/热搜词的榜单和列表查询（如 queryShopeeItemRanking、queryShopeeBrandRanking、queryShopeeWordRanking、queryShopeeShopRanking、queryShopeeCatRanking）都依赖此接口获取类目ID。可选站点：tw(台湾)、my(马来西亚)、id(印度尼西亚)、th(泰国)、ph(菲律宾)、sg(新加坡)、vn(越南)、br(巴西)。

请求参数

Authorization

API Key

在 header 添加参数

Authorization

示例：

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

Body 参数application/json必填

示例

{
    "site": "tw",
    "language": "th-TH"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/api/shopee/categories/level1/query' \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "site": "tw",
    "language": "th-TH"
}'

返回响应

🟢200

*/*

Body*/*

示例

{
    "success": true,
    "errorCode": "string",
    "errorMessage": "string",
    "data": [
        {
            "categoryId": 100001,
            "categoryLevel": 1,
            "categoryName": "书籍与杂志",
            "language": "zh-CN",
            "parentId": 0,
            "site": "tw"
        }
    ]
}

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

查询 Shopee 二级类目

查询类目趋势快照