tiktok-shop/
hot-products

地域コードを指定してTikTok Shop市場の売れ筋商品を取得し、商品名、価格と通貨、販売数、評価、ショップを、TikTok Shopのランキング順で返します。

TikTok Shop Hot Products API

市場コードを入力
順位付きの売れ筋商品
現地通貨の価格
販売数
結果1件あたり0.5クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

TikTok Shop Hot Products

TikTok Shop Hot Products は1つの市場における売れ筋商品のランキングで、各商品に商品名、現地通貨の価格、販売数、評価、レビュー数、ショップ、商品画像が付いています。順位どおりに読み、週ごとに比べれば、どの商品が急伸しているか、どの価格帯で売れているか、どのショップが上位に入り続けているかがわかります。

TikTok Shop Hot Products API の主な機能

  • 入力は地域コードだけregion で1つの市場(ID、JP、MX、MY、PH、SG、TH、VN)を選ぶだけで、キーワード、カテゴリ、ショップのリンクを用意しなくても一覧が返ります。
  • TikTok Shopの順位を保ったランキング商品はTikTok Shopが並べる順に1リクエスト最大200件で返るため、行の位置がそのままランキング上の順位になります。
  • 市場の現地通貨での価格price は数値の amount、MYR などの通貨コード、表示用の価格テキストに分かれており、並べ替えや価格帯の分析にそのまま使えます。
  • 需要と評判のシグナル各商品に sold_count、rating、reviews_count が付き、どれだけ売れて購入者にどう評価されたかをすばやく読み取れます。
  • ショップと商品画像seller は各商品を扱うショップを id とともに示し、media には商品画像が幅と高さ付きで並びます。

TikTok Shop Hot Products API のパラメータ

パラメータ必須説明
region必須ランキングを取得する市場です。ID、JP、MX、MY、PH、SG、TH、VN から選びます。
results_limit任意返す順位付き商品の数で、1〜200です。デフォルトは50です。

TikTok Shop Hot Products API の使い方

市場を選び、ランキングのどこまで読むかを決めて、一覧を取得します。

  1. {"region": "MY", "results_limit": 50} を /v1/tiktok-shop/hot-products に POST し、返された task_id を控えます。
  2. status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングします。
  3. results.items から順位付きの商品を順番に読み取り、has_more が true の間は results.next_cursor で続けます。
curl -X POST "https://api.socq.ai/v1/tiktok-shop/hot-products" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"region":"MY","results_limit":50}'

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

  • 市場ごとの売れ筋の週次ウォッチ: 毎週、各商品の id、順位、sold_count を保存して比較し、どの商品がランキングに入り、順位を上げ、圏外に落ちたかを把握します。
  • 価格帯のベンチマーク: 同じ通貨内で price.amount を並べ替え、市場の売れ筋商品が集中する価格帯を見つけてから、自社商品の価格を決めます。
  • 仕入れ候補リストの作成: title、media の画像、sold_count、rating を組み合わせて仕入れや販促に値する商品を選び、url から各商品ページへ戻れるようにします。
  • ショップの集中度チェック: 上位付近に各 seller.id が何回現れるかを数え、少数のショップが市場を占めているのか、一覧が幅広く分散しているのかを確かめます。

TikTok Shop Hot Products API 活用のヒント

  • ランキングは rank フィールドではなく行の並び順で表されるため、results.items を読みながら、カーソルのページをまたいで数え続けて各商品の順位を自分で記録してください。
  • 市場間で価格を比べる前に price.currency でグループ化し、計算は表示用テキストではなく price.amount で行ってください。
  • sold_count、rating、reviews_count が null の場合はゼロではなく未報告として扱い、平均や並べ替えの意味が崩れないようにしてください。
  • 週ごとの比較でランキングの同じ深さを対象にできるよう、region と results_limit は実行ごとに固定してください。

TikTok Shop Hot 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 Categories API — TikTok Shop市場のカテゴリツリー全体を、カテゴリID、名前、英語のスラッグ、階層、親カテゴリ、パスとともに取得します。
  • TikTok Shop Category Products API — カテゴリIDと市場から、TikTok Shopカテゴリの商品を価格、販売数、評価、レビュー、ショップとともに一覧にします。

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

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

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

TikTok Shop Hot Products APIは、地域コードで選んだ1つのTikTok Shop市場の売れ筋商品ランキングを取得するためのプログラムインターフェースです。各商品の商品名、説明、ショップ、価格と通貨、販売数、評価、レビュー数、画像をランキング順で返します。

region には ID、JP、MX、MY、PH、SG、TH、VN を1リクエストにつき1市場指定できます。米国の商品は、どちらも region に US を指定できる TikTok Shop Category Products でカテゴリを閲覧するか、TikTok Shop Search でキーワード検索してください。

行はTikTok Shopのランキング順に並ぶため、results.items の最初の商品が一覧のトップです。全体の順序を保つには、後続の結果ページも順番どおりに読んでください。

results_limit は1〜200でデフォルトは50なので、1回のリクエストで市場の上位200商品までカバーできます。

返された商品1件につき0.5クレジットで、デフォルトの50件なら25クレジットです。