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 の使い方
市場を選び、ランキングのどこまで読むかを決めて、一覧を取得します。
- {"region": "MY", "results_limit": 50} を /v1/tiktok-shop/hot-products に POST し、返された task_id を控えます。
- status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングします。
- 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 は実行ごとに固定してください。
関連API
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カテゴリの商品を価格、販売数、評価、レビュー、ショップとともに一覧にします。