クリエイターカテゴリツリーを取得

Scrumballがクリエイターに割り当てる階層カテゴリ分類を親子IDとともに返します。カテゴリIDは各プラットフォームのクリエイター検索エンドポイントで使用できます。

GET/api/v1/search/categories

クォータ消費: このエンドポイントへの成功したリクエスト 1 件あたり、プランのクォータが 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

お試し実行

リクエストURL

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

Authorization

ダッシュボードのAPIキーを選択

リクエストを送信する前にAPIキーを入力してください。ダッシュボードを開く

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に対応付けます。
カテゴリ選択UI — 社内の人選ツールに階層カテゴリセレクターを表示します。