TikTok Shop Categories
TikTok Shop Categories は市場ごとの商品分類体系で、すべてのカテゴリがID、現地語の名前、英語のスラッグ、階層の深さ、親カテゴリ、上位カテゴリ名の連なりを持っています。ツリーとして並べると、その市場が商品をどうグループ分けしているかがわかり、カタログの対応付け、カテゴリ調査の計画、1つの分岐の閲覧に必要なIDがそろいます。
TikTok Shop Categories API の主な機能
- 1回の呼び出しで全カテゴリ1回のリクエストで、選んだ市場のツリー全体が最上位の大分類から最下層のサブカテゴリまで、それぞれ1行として返ります。
- 親カテゴリ、階層、末端フラグparent_id は各行を1つ上のカテゴリに結び付け、level は最上位を1とした深さを数え、is_leaf はサブカテゴリを持たないカテゴリを示します。
- path に上位カテゴリ名path には最上位から順に、その行より上のすべてのカテゴリ名が並ぶため、ツリーをたどらなくても深いカテゴリを文脈付きで表示できます。
- カテゴリの商品を開くID各 id は TikTok Shop Category Products に category_id として渡せ、そのカテゴリに属する商品を一覧にできます。
TikTok Shop Categories API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
region | 任意 | カテゴリツリーを返す市場です。US、SG、MY、PH、TH、VN、ID、JP、MX から選びます。デフォルトは US です。 |
TikTok Shop Categories API の使い方
1つの市場のツリーをリクエストし、返された行からツリーを組み立てます。
- {"region": "US"} を /v1/tiktok-shop/categories に POST します。region を省略すると米国のツリーが返ります。
- タスクが成功するまで GET /v1/tasks/{task_id} をポーリングします。
- results.items からすべての行を集め、has_more が true の間は results.next_cursor をたどってから、parent_id で行を入れ子にします。
curl -X POST "https://api.socq.ai/v1/tiktok-shop/categories" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"region":"US"}'TikTok Shop Categories API の主なユースケース
- カテゴリメニューの再現: 行を parent_id で入れ子にして level 順に並べ、ラベルに name、アイコンに cover_url を使って、市場のカテゴリナビゲーションを再現します。
- 自社カタログとの対応付け: name、slug、path を自社の商品カテゴリと照合し、自社の分類とその市場でTikTok Shopが使う分類を相互に変換します。
- カテゴリ網羅調査の計画: 選んだ大分類の下で is_leaf が true の行に絞り込み、TikTok Shop Category Products に送るIDのリストを作ります。
TikTok Shop Categories API 活用のヒント
- has_more が true の場合は、ツリーを組み立てる前に results.next_cursor で最後のページまでたどってください。ページが欠けると子の行が親を失います。
- parent_id が空で level が1の行をツリーのルートとして扱ってください。その path は空のリストです。
- ツリーは市場ごとに異なるため、カテゴリIDは、ツリーを取得したときと同じ region を付けて TikTok Shop Category Products に送ってください。
関連API
TikTok Shop Categories API 以外に別の種類の公開TikTok Shopデータが必要な場合は、これらのAPIをご利用ください。
- TikTok Shop Search API — キーワードと市場地域で公開TikTok Shopの商品を検索し、出品者、価格、メディア、評価、レビュー、販売数の各フィールドを返します。
- TikTok Shop Products API — TikTok ShopのストアURL 1件から公開商品を取得し、出品者、価格、メディア、カテゴリ、SKU、評価、レビュー、販売数の各フィールドを返します。
- TikTok Shop Product API — PDP URLからTikTok Shopの公開商品1件を取得し、出品者、価格、メディア、カテゴリ、SKU、評価、レビュー、販売数の各フィールドを返します。
- TikTok Shop User Showcase API — TikTokユーザー名1件について公開ショーケースの商品を取得し、価格、出品者、メディア、評価、レビュー、販売数、地域情報を返します。
- TikTok Shop Hot Products API — 地域コードで選んだTikTok Shop市場の売れ筋商品を、ランキング順に価格と通貨、販売数、評価、ショップとともに取得します。
- TikTok Shop Category Products API — カテゴリIDと市場から、TikTok Shopカテゴリの商品を価格、販売数、評価、レビュー、ショップとともに一覧にします。