TikTok Live Ranking
TikTok LIVEの日次ランキングは、その日のライブ配信者のリーダーボードで、配信中に視聴者が贈ったギフトから算出したスコアの順に並び、各エントリーには配信者の順位、スコア、フォロワー数が付きます。これを読めば、今日どの配信者が視聴者に支えられているか、上位がどう入れ替わるか、フォロワー数から想像する以上に支持を集めている小さなアカウントはどれかがわかります。
TikTok Live Ranking API の主な機能
- パラメータなしでボード全体を取得リクエストに入力はなく、現在の日次ランキングが最大99人分、それぞれ rank 付きで返ります。
- オーディエンス規模と並べたスコアscore はギフトにもとづくランキング値、followers_count は配信者のフォロワー総数で、支持と規模を追加の照会なしで比べられます。
- 全行に配信者の情報author に配信者のユーザーID、ユーザー名、表示名、プロフィールリンク、アバターが入ります。
TikTok Live Ranking API のパラメータ
送信できます
このエンドポイントにはリクエストパラメータは不要です。空のJSONオブジェクトをそのまま送信してください。
{}TikTok Live Ranking API の使い方
空のリクエストを送信して、ランキング入りした配信者を読み取ります。
- {} を /v1/tiktok/live-ranking に 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-ranking" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{}'
# Each item has rank, score, author and followers_count.TikTok Live Ranking API の主なユースケース
- 一日を通じたボードの推移の追跡: 決まった時刻にランキングを取得し、配信者ごとの rank と score をグラフにして、誰が上がっているか、順位がいつ入れ替わるかを見ます。
- 事務所やスポンサー向けの配信者スカウト: score を followers_count で割って、オーディエンスの規模のわりに視聴者の贈るギフトが多い配信者を見つけ、契約やスポンサーの候補に絞り込みます。
TikTok Live Ranking API 活用のヒント
- 取得は毎日同じ時刻に行ってください。正午に読んだスコアと深夜に読んだスコアは、同じ一日の中でも対象となる時間帯が違います。
- ランキングにライブ状況は含まれません。author.id で配信者を突き合わせ、ユーザー名を TikTok User Live に渡すと、いま誰が配信中かがわかります。
関連API
TikTok Live Ranking API 以外に別の種類の公開TikTokデータが必要な場合は、これらのAPIをご利用ください。
- TikTok Profiles API — ユーザー名から、公開プロフィールのアカウント情報、プロフィール文、アカウント属性、オーディエンス数を取得します。
- TikTok Followers List API — 公開フォロワーリストに表示されているプロフィールを正規化して取得し、取得元の情報と対応する指標を保持します。
- TikTok Following List API — TikTokアカウントがフォローしている公開プロフィールを、正規化されたアカウント情報、プロフィール文、表示中の指標、元のアカウント情報とともに取得します。
- TikTok User Live API — ユーザー名ごとにライブ配信中かオフラインかを確認し、取得可能なライブ配信ルームの詳細を返します。
- TikTok Audience Demographics API — ユーザー名から、クリエイターのフォロワーがどの国にいるかを、各国がオーディエンスに占める割合とともに確認します。
- TikTok Live Search API — キーワードで現在配信中のライブ配信を探し、配信者、タイトル、現在の視聴者数を返します。
- TikTok Hashtags API
- TikTok Comments API
- TikTok Videos API
- TikTok Search API
- TikTok Comment Replies API
- TikTok User Videos API
- TikTok Live Room Info 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 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 Shopping API
- TikTok Fake Views Checker API
- TikTok Comment Keywords API