Get Creator Category Tree

Returns the hierarchical category taxonomy Scrumball assigns to creators, with parent and child ids. Category ids are accepted by the creator search endpoints on every platform.

GET/api/v1/search/categories

Quota usage: Each successful request to this endpoint deducts 100 quota units from your plan.

Request Parameters

Required Parameters

This endpoint has no required parameters.

Response Fields

Name	Type	Description
`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

Try It

Request URL

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

Authorization

Select an API key from Dashboard

Add an API key before sending a request.Go to Dashboard

cURL Example

bash

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

Response Example (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": [
        {}
      ]
    }
  ]
}

Use Cases

Search filter setup — Load the tree once and map your product categories to creator category ids.
Category picker UI — Render a cascading category selector in an internal sourcing tool.