tiktok-shop/
categories

任意の地域コードからTikTok Shop市場の商品カテゴリツリー全体を取得し、カテゴリごとに1行で、ID、名前、英語のスラッグ、階層、親カテゴリ、パスを返します。

TikTok Shop Categories API

カテゴリツリー全体
地域の指定は任意
親カテゴリと階層
カテゴリID
1リクエストあたり0.5クレジット
準備完了
準備完了

パラメータを入力してリクエストを送信してください。タスクのステータスと正規化された結果がここに表示されます。

README

SocQ 編集 · 更新

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つの市場のツリーをリクエストし、返された行からツリーを組み立てます。

  1. {"region": "US"} を /v1/tiktok-shop/categories に POST します。region を省略すると米国のツリーが返ります。
  2. タスクが成功するまで GET /v1/tasks/{task_id} をポーリングします。
  3. 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 に送ってください。

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カテゴリの商品を価格、販売数、評価、レビュー、ショップとともに一覧にします。

他のプラットフォームを見る

TikTok Shopのデータを、対応する他のソーシャルプラットフォームの公開データと組み合わせられます。

TikTok Shop Categories API — よくある質問

TikTok Shop Categories APIは、任意の地域コードで選んだ1つのTikTok Shop市場について、商品カテゴリツリーの全体を取得するためのプログラムインターフェースです。各カテゴリのID、名前、英語のスラッグ、親カテゴリ、階層、末端フラグ、上位カテゴリのパス、アイコンのURLを返します。

region には US、SG、MY、PH、TH、VN、ID、JP、MX を指定でき、省略すると US になります。

parent_id がそのカテゴリの id と一致する行を選んでください。is_leaf が true の行はサブカテゴリを持たず、その分岐の終点です。

name は市場の表示言語に従い、slug はすべてのカテゴリに英語のURLラベルを付けるため、ほかの言語の市場を読むときに役立ちます。

ツリーの行数にかかわらず、1回の呼び出しにつき0.5クレジットで、その市場の全カテゴリが返ります。