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 の使い方
キーワードで検索して、いま配信中のライブを読み取ります。
- {"query": "deals", "results_limit": 20} を /v1/tiktok/search-live に 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/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 に切り替えてください。
関連API
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 Comments API
- TikTok Videos 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 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