tiktok/
live-ranking

TikTok LIVEのクリエイター日次ランキングを1回の呼び出しで取得できます。最大99人の配信者について、順位、ギフトにもとづくスコア、ユーザーID、ユーザー名、表示名、フォロワー数、プロフィールリンクを返します。

TikTok Live Ranking API

入力不要
最大99人の配信者
ギフトにもとづくスコア
1リクエストあたり0.5クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

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

空のリクエストを送信して、ランキング入りした配信者を読み取ります。

  1. {} を /v1/tiktok/live-ranking に 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/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 に渡すと、いま誰が配信中かがわかります。

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

TikTok Live Ranking API — よくある質問

TikTok Live Ranking APIは、入力なしでTikTok LIVEのクリエイター日次ランキングを読み取るためのプログラムインターフェースです。最大99人の配信者について、順位、ギフトにもとづくスコア、ユーザーID、ユーザー名、表示名、フォロワー数を返します。

score は、TikTokが今日その配信者を順位づけしている値で、配信で受け取ったギフトにもとづきます。ランキング用のスコアであり、いずれかの通貨での支払額ではありません。

このエンドポイントでは取得できません。入力はなく、現在の日次ランキングが返るだけなので、履歴が必要な場合は取得結果を自分で保存してください。

ギフトが届くたびに、一日の中で順位が動きます。1回の取得はボード全体で一律0.5クレジットなので、1時間おきに取得しても1日12クレジットです。

いいえ。ランキングはギフトを受け取った配信者の順位で、各配信者の順位、スコア、プロフィールは取得できますが、贈った人の一覧はありません。