TikTok Live Shopping
TikTok LIVEのショッピングバッグは、配信者が配信中に販売する商品の一覧で、どの商品にもタイトル、通貨付きの価格、販売数、出品者、画像が付いています。バッグを読めば、その配信が何を推しているか、配信中にどんな価格で出しているか、すでにまとまった数が売れている商品はどれかがわかります。
TikTok Live Shopping API の主な機能
- バッグ内のすべての商品room_id と配信者の user_id を指定すると、そのルームのショッピングバッグにある商品が1件ずつレコードになって返ります。上限は results_limit で指定する500件です。
- 価格は金額・通貨・表示テキストでprice.amount、price.currency、price.formatted で、数値、通貨コード、視聴者に表示される文字列が取れます(例:41.6、USD、$41.60)。
- 販売数は整数でsold_count は 101600 のような整数なので、バッグをそのまま並べ替えたり比較したりできます。
- 商品リンク、出品者ID、画像各レコードには、url に商品ページ、seller.id に出品者のID、media に幅と高さつきの商品画像が入ります。
TikTok Live Shopping API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
room_id | 必須 | LIVEルームの数値IDです。TikTok Live Search の結果の id を使います。 |
user_id | 必須 | 配信者の数値のTikTokユーザーIDです。同じ Live Search の結果の author.id を使います。 |
results_limit | 任意 | 取得する商品の件数です。1〜500の範囲で指定し、デフォルトは100です。 |
TikTok Live Shopping API の使い方
ショッピング配信を見つけて、配信中のバッグを一覧します。
- ショッピング関連のキーワードで TikTok Live Search を実行し、結果の id と author.id を取得します。
- {"room_id": "7704767945901132575", "user_id": "7153432386608251946"} を /v1/tiktok/live-products に POST します。
- status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングし、results.items から商品を読み取ります。has_more が true の間は results.next_cursor を渡して続きを取得します。
curl -X POST "https://api.socq.ai/v1/tiktok/live-products" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"room_id":"7704767945901132575","user_id":"7153432386608251946","results_limit":100}'
# Each item is one product with title, price and sold_count.TikTok Live Shopping API の主なユースケース
- 競合のライブバッグを読む: Live Search で競合の配信者の room_id と user_id を取得し、バッグ全体を一覧して、どの商品をどの価格帯で出しているかを確認します。
- 配信中の価格変動を追う: 同じルームを数分おきに読み、商品 id ごとに price.amount を比べると、配信者が配信中に告知する値下げを捉えられます。
- バッグ内の売れ筋を見つける: バッグを sold_count で並べ替えて、すでに最も多く売れている商品を見つけ、価格と照らし合わせます。
TikTok Live Shopping API 活用のヒント
- ルームをまたいで価格を比べる前に、price.currency を確認してください。金額は通貨とセットで初めて意味を持ちます。
- 読み取りを重ねるときは、商品の id で同じ商品を突き合わせてください。変化するのは price.amount と sold_count です。
関連API
TikTok Live Shopping API 以外に別の種類の公開TikTokデータが必要な場合は、これらのAPIをご利用ください。
- TikTok Profiles API — ユーザー名から、公開プロフィールのアカウント情報、プロフィール文、アカウント属性、オーディエンス数を取得します。
- TikTok Hashtags API — 指定したハッシュタグの公開動画、クリエイター、メディア、サウンド、エンゲージメントを取得します。
- TikTok Comments API — 公開トップレベルコメント、投稿者、エンゲージメント、メンション、クリエイターとのやり取りを示すフラグを取得します。
- TikTok Videos API — 動画URLから、クリエイター、キャプション、メディア、音楽、タグ、メンション、エンゲージメントを取得します。
- TikTok Live Room Info API — ルームIDと配信者IDの組み合わせで既知のライブ配信ルーム1件を検索し、ステータス、配信者情報、カバーメディア、視聴者数を返します。
- TikTok Live Search API — キーワードで現在配信中のライブ配信を探し、配信者、タイトル、現在の視聴者数を返します。
- TikTok Search API
- TikTok Comment Replies API
- TikTok Followers List API
- TikTok Following List API
- TikTok User Videos API
- TikTok Trending Feed API
- TikTok Video Transcript API
- TikTok Search Users API
- TikTok Song API
- TikTok Song Videos API
- TikTok Popular Songs API
- TikTok Top Search API
- TikTok User Live API
- TikTok Audience Demographics API
- TikTok Similar Accounts API
- TikTok Reposts API
- TikTok Playlists API
- TikTok Hashtag Views API
- TikTok Sound Search API
- TikTok Photo Search API
- TikTok Trending Searches API
- TikTok Creator Search Insights API
- TikTok Live Ranking API
- TikTok Fake Views Checker API
- TikTok Comment Keywords API