获取网红分类树

返回 Scrumball 为红人划分的层级分类体系，含父子 ID。分类 ID 可用于各平台的红人搜索接口。

GET/api/v1/search/categories

额度扣减: 本接口每次成功请求会从套餐额度中扣减 100 单位。

请求参数

必填参数

该接口没有必填参数。

响应字段

名称	类型	说明
`success`	boolean	Success
`code`	integer	Code
`message`	string	Message
`data`	array<object>	Data
`data[].id`	integer	Category ID
`data[].zh_name`	string	Chinese name
`data[].en_name`	string	English name
`data[].level`	integer	Level (1 = top, 2 = second, 3 = third)
`data[].selectable`	boolean	Usable in search (top-level categories are for grouping only and cannot be selected)
`data[].children`	array<object>	Child categories; empty for third-level categories

在线调试

请求地址

https://openapi.scdata.cc/api/v1/search/categories

鉴权

请先从 Dashboard 选择一个 API key

发送请求前请先准备一个 API key。前往 Dashboard

cURL 示例

bash

curl -X GET "https://openapi.scdata.cc/api/v1/search/categories" \
  -H "Authorization: YOUR_API_KEY"

响应示例 (200 application/json)

json

{
  "success": true,
  "code": 200,
  "message": "Request successful",
  "data": [
    {
      "id": 9001,
      "zh_name": "Beauty & personal care",
      "en_name": "Beauty & Personal Care",
      "level": 1,
      "selectable": false,
      "children": [
        {}
      ]
    }
  ]
}

使用场景

搜索筛选配置 — 一次性加载分类树，把你的商品类目映射到红人分类 ID。
分类选择器 — 在内部选人工具中渲染级联分类选择器。