tiktok/
search-live

キーワードでTikTok LIVEを検索し、いま配信中のライブを取得できます。ルームID、配信者ID、タイトル、現在の視聴者数、いいね数、開始時刻を返し、ライブショッピングの調査にそのまま使えます。

TikTok Live Search API

キーワード検索
配信中のみ
ルームIDと配信者ID
結果1件あたり0.6クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

TikTok Live Search

TikTok LIVEのルームとは、いままさに行われている1つの配信のことで、ルームIDで識別され、タイトル、配信者、リアルタイムの視聴者数、累計のいいね数、開始時刻を持っています。キーワードに一致するルームを調べると、そのテーマでいま誰が配信していて、視聴者がどのくらいいるかがわかり、ライブショッピングの調査、配信者探し、ブランド周辺のライブ動向の追跡の出発点になります。

TikTok Live Search API の主な機能

  • キーワードを入れると配信中のライブが返るquery に1つのキーワードを指定すると、その時点で配信中のライブが返り、すべて status が live になります。
  • ルームIDと配信者IDを1件のレコードにid がルームID、author.id が配信者のユーザーIDで、この2つは TikTok Live Shopping でそのライブの商品を一覧するときに必要になる値です。
  • 収集時点の視聴者数metrics.viewers_count はルームにいる人数、metrics.likes_count はそれまでに集まったいいね数で、collected_at の時刻が付きます。
  • タイトル、開始時刻、カバー、LIVEページ各レコードには、配信タイトル、published_at の開始時刻、media のカバー画像、url の配信者のLIVEページへのリンクに加え、配信者のユーザー名、表示名、アバターが入ります。

TikTok Live Search API のパラメータ

パラメータ必須説明
query必須LIVE配信を探すキーワードです。
results_limit任意取得する配信の件数です。1〜200の範囲で指定し、デフォルトは20です。

TikTok Live Search API の使い方

キーワードで検索して、いま配信中のライブを読み取ります。

  1. {"query": "deals", "results_limit": 20} を /v1/tiktok/search-live に POST します。
  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/search-live" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"deals","results_limit":20}'

# id is the room ID; author.id is the host ID for TikTok Live Shopping.

TikTok Live Search API の主なユースケース

  • 競合のライブ販売の偵察: deals など、出品者が配信中に口にする商品ワードで検索し、各ルームの id と author.id を TikTok Live Shopping に渡して、ショッピングバッグの中身を読み取ります。
  • キーワード周辺のライブ動向の集計: 同じクエリを定期的に実行して、配信中の本数とその viewers_count を記録すると、あるテーマやブランドがいつライブの視聴者を集めるかがわかります。
  • コラボ候補の配信者の絞り込み: テーマに沿ってライブ配信中の配信者を集め、viewers_count と likes_count で順位をつけてから、連絡を取ります。

TikTok Live Search API 活用のヒント

  • 同じジャンルの言い回しを変えて複数回検索し、id で結果を統合してください。キーワードごとに返る配信は異なり、1つの配信が複数のキーワードに一致することもあります。
  • id と author.id は別々に保存してください。id は1回の配信、author.id は配信者を表すので、日をまたいで配信者を追うときは author.id を使います。
  • 特定のルームの視聴者数を時間を追って見たいときは、検索の繰り返しをやめ、そのルームの room_id と user_id を指定して TikTok Live Room Info に切り替えてください。

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

  • TikTok Profiles API — ユーザー名から、公開プロフィールのアカウント情報、プロフィール文、アカウント属性、オーディエンス数を取得します。
  • TikTok Hashtags API — 指定したハッシュタグの公開動画、クリエイター、メディア、サウンド、エンゲージメントを取得します。
  • TikTok Search API — キーワードで公開動画を検索します。対応する並び順と公開日のフィルターを指定できます。
  • TikTok Live Room Info API — ルームIDと配信者IDの組み合わせで既知のライブ配信ルーム1件を検索し、ステータス、配信者情報、カバーメディア、視聴者数を返します。
  • TikTok Search Users API — キーワードで公開TikTokアカウントを検索します。
  • TikTok Live Shopping API — ライブ配信のショッピングバッグにある商品を、現在の価格と販売数とともに一覧で取得します。

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

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

TikTok Live Search API — よくある質問

TikTok Live Search APIは、キーワードに一致する、いま配信中のTikTok LIVEを探すためのプログラムインターフェースです。件数は results_limit で指定でき、各レコードにはルームID、配信者ID、タイトル、現在の視聴者数、いいね数、カバー画像、開始時刻が入ります。

結果の id を room_id、author.id を user_id として TikTok Live Shopping に渡してください。2つの値は、同じ結果から取る必要があります。

results_limit には1〜200を指定でき、デフォルトは20です。一致する配信が少なければ、その分で一覧が終わります。返された配信は1件につき0.6クレジットで、一致がない検索は課金されません。

いいえ。検索を送信した時点で配信中のライブだけが一覧になり、すべてのレコードの status は live です。過去の配信は返りません。

ライブは一日中、開始と終了を繰り返しているため、配信中の顔ぶれが実行のたびに変わります。配信を識別するキーには id、取得した時刻には collected_at を使ってください。

リクエストで指定できるのは query と results_limit だけです。結果の metrics.viewers_count を読み取って、手元で絞り込んでください。

このエンドポイントはキーワードで検索します。アカウントがわかっている場合は、ユーザー名を受け取って各アカウントのライブ状況を返す TikTok User Live を使ってください。