tiktok-shop/
category-products

カテゴリIDと市場からTikTok Shopカテゴリの商品を一覧にし、商品名、価格と通貨、販売数、評価、レビュー、ショップを1回の呼び出しで最大500件返します。

TikTok Shop Category Products API

カテゴリIDを入力
9つの市場
最大500商品
結果1件あたり0.5クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

TikTok Shop Category Products

TikTok Shop Category Products は市場の1つのカテゴリに登録された商品で、それぞれに商品名、説明、価格と通貨、販売数、評価、レビュー数、ショップ、画像が付いています。カテゴリごとに取得すると、その分野の価格帯、売れ筋商品、活発なショップと、それらがサブカテゴリごとにどう違うかが見えてきます。

TikTok Shop Category Products API の主な機能

  • キーワードではなくカテゴリIDで閲覧category_id には TikTok Shop Categories が返す数値IDを指定するため、検索語を推測しなくてもカテゴリの商品を直接読み取れます。
  • 9つの市場、デフォルトは米国region は US、SG、MY、PH、TH、VN、ID、JP、MX に対応し、省略すると US になります。
  • 1カテゴリあたり最大500商品results_limit は1〜500でデフォルトは30なので、1回のリクエストでカテゴリの簡単なサンプルも深い範囲の取得もできます。
  • すべての商品にコマース情報各行には title、text、amount と currency を含む price、sold_count、rating、reviews_count、seller、media の画像と、商品ページの url が入ります。

TikTok Shop Category Products API のパラメータ

パラメータ必須説明
category_id必須TikTok Shop Categories の id フィールドから取得した数値のカテゴリIDです(例:601450)。
region任意カテゴリの市場です。US、SG、MY、PH、TH、VN、ID、JP、MX から選びます。デフォルトは US です。
results_limit任意返す商品の数で、1〜500です。デフォルトは30です。

TikTok Shop Category Products API の使い方

TikTok Shop Categories からカテゴリIDを取り、その配下の商品を読み取ります。

  1. {"category_id": "601450", "region": "US", "results_limit": 30} を /v1/tiktok-shop/category-products に POST します。
  2. GET /v1/tasks/{task_id} をポーリングします。status が succeeded になれば商品の準備は完了です。
  3. results.items から商品を読み取り、has_more が true の場合は results.next_cursor で次のページをリクエストします。
curl -X POST "https://api.socq.ai/v1/tiktok-shop/category-products" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category_id":"601450","region":"US","results_limit":30}'

TikTok Shop Category Products API の主なユースケース

  • サブカテゴリ間の価格帯比較: 子カテゴリごとに1回ずつリクエストし、price.amount の分布を比べて、各サブカテゴリの商品がどの価格帯にあるかを確かめます。
  • カテゴリの売れ筋の追跡: 同じカテゴリを定期的に再取得して商品の id ごとに sold_count を追い、販売数を伸ばし続けている商品を見つけます。
  • 分野内のショップの把握: 商品を seller.id と seller.name でグループ化し、カテゴリ内で商品数がもっとも多いショップや販売数がもっとも多いショップを見つけます。

TikTok Shop Category Products API 活用のヒント

  • 市場ごとにカテゴリツリーが異なるため、TikTok Shop Categories でカテゴリIDを取得したときと同じ region を使ってください。
  • カテゴリは商品行のフィールドではなくリクエストに由来するため、残す商品には送信した category_id を並べて保存してください。
  • 複数のカテゴリや繰り返しの実行をまとめるときは id をキーにし、2回取得された商品を1回だけ数えるようにしてください。

TikTok Shop Category Products API 以外に別の種類の公開TikTok Shopデータが必要な場合は、これらのAPIをご利用ください。

  • TikTok Shop Products API — TikTok ShopのストアURL 1件から公開商品を取得し、出品者、価格、メディア、カテゴリ、SKU、評価、レビュー、販売数の各フィールドを返します。
  • TikTok Shop Product API — PDP URLからTikTok Shopの公開商品1件を取得し、出品者、価格、メディア、カテゴリ、SKU、評価、レビュー、販売数の各フィールドを返します。
  • TikTok Shop Product Reviews API — TikTok ShopのPDP URL 1件について公開レビューを取得し、本文、評価、レビュー投稿者、画像、SKU、国、購入情報の各フィールドを返します。
  • TikTok Shop User Showcase API — TikTokユーザー名1件について公開ショーケースの商品を取得し、価格、出品者、メディア、評価、レビュー、販売数、地域情報を返します。
  • TikTok Shop Hot Products API — 地域コードで選んだTikTok Shop市場の売れ筋商品を、ランキング順に価格と通貨、販売数、評価、ショップとともに取得します。
  • TikTok Shop Categories API — TikTok Shop市場のカテゴリツリー全体を、カテゴリID、名前、英語のスラッグ、階層、親カテゴリ、パスとともに取得します。

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

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

TikTok Shop Category Products API — よくある質問

TikTok Shop Category Products APIは、カテゴリIDと市場で特定した1つのTikTok Shopカテゴリの商品を一覧にするためのプログラムインターフェースです。各商品の商品名、説明、価格と通貨、販売数、評価、レビュー数、ショップ、画像、商品ページのURLを返します。

TikTok Shop Categories を実行し、目的のカテゴリの id をコピーしてください。IDは 601450 のように数字だけで構成されています。

ツリー内のどのカテゴリIDも受け付けられます。「使い方」のリクエスト例では最上位カテゴリ Beauty & Personal Care の 601450 を送っており、より深いIDを使えば一覧を1つの分岐に絞り込めます。

商品1件につき0.5クレジットで、デフォルトの30件なら15クレジット、上限の500件なら250クレジットです。