tiktok/
live-products

ルームIDと配信者IDから、TikTok LIVE配信のショッピングバッグにある商品を一覧で取得できます。商品名、現在の価格、販売数、出品者ID、商品リンク、画像を返します。

TikTok Live Shopping API

ルームIDと配信者ID
ショッピングバッグの商品
最大500商品
結果1件あたり0.1クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

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 の使い方

ショッピング配信を見つけて、配信中のバッグを一覧します。

  1. ショッピング関連のキーワードで TikTok Live Search を実行し、結果の id と author.id を取得します。
  2. {"room_id": "7704767945901132575", "user_id": "7153432386608251946"} を /v1/tiktok/live-products に POST します。
  3. 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 です。

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のデータを、対応する他のソーシャルプラットフォームの公開データと組み合わせられます。

TikTok Live Shopping API — よくある質問

TikTok Live Shopping APIは、配信の room_id と配信者の user_id から、TikTok LIVE配信のショッピングバッグにある商品を一覧取得するためのプログラムインターフェースです。商品ごとのタイトル、価格、販売数、出品者ID、リンク、画像を返します。

TikTok Live Search を実行し、結果の id を room_id、author.id を user_id として使います。この2つは、同じ結果から取る必要があります。

results_limit には1〜500を指定でき、デフォルトは100です。バッグがそれより小さければ、そこで終わります。返された商品は1件につき0.1クレジットなので、500商品のバッグを丸ごと読むと50クレジットです。

そのルームで配信者がショッピングバッグを設定していないか、ルームがすでに配信を終えているためです。結果が空の場合は課金されません。

できません。バッグを取得するときは、ルームが配信中である必要があります。配信中に読み取り、あとでラインナップが必要なら保存しておいてください。

sold_count はTikTokが商品について報告している販売数で、報告がない場合は null です。配信中にどれだけ動いたかを見るには、バッグを2回読んで差を取ってください。