tik.toolsによる
TikTok LIVEデータの収集方法

データの出どころ

tik.toolsは、TikTokがアプリ内で表示しているTikTok LIVEのランキングボードとLIVEルームを読み取っています。日間、リーグ、ゲーミング、ショッピング、人気LIVE、チームの各ボードと、そこに載っているクリエイターの公開LIVEルームです。ボード上の数値はすべて、取得した時点でTikTokが表示していた値です。推定値と明記しているものを除き、tik.toolsが数値を調整、平滑化、予測することはありません。

tik.toolsは独立したサービスであり、TikTokおよびByteDanceとは提携していません。

ボードと更新頻度

各ボードはそれぞれのスケジュールで再取得しています。下の間隔は新しいデータを取得しにいく頻度です。全地域を一巡するには一回の間隔より長くかかることがあり、ページやAPIレスポンスにはさらに最大一分ほどのキャッシュが加わる場合があります。各ボードのページにはデータの取得時刻が表示されているので、数値を引用するときはその時刻も添えてください。

日間ボードは、各地域のリセット時刻（下の地域一覧に記載）に一日一回リセットされるため、日間スコアは現在のランキング日の累計です。リーグのディビジョンは毎週月曜日、その地域のリセット時刻にリセットされます。トルコと中東・アフリカにはTikTokの日間ボードがないため、これらの地域では毎時ボードを表示しており、リーグのディビジョンは毎日リセットされます。

地域と国

tik.toolsは44のTikTok LIVE地域をランキングしています。地域とは、TikTokのランキングプール一つのことで、一か国または複数の国をまとめてTikTokが公開する一つの日間ボードを指します。クリエイターの地域とはランキングに参加しているプールのことで、国籍ではありません。TikTokは個々のクリエイターの国を公開していないため、tik.toolsも国を割り当てていません。

これらの地域のほかに、TikTokはプール内の一部の国について単独のボードを公開しています。これらのボードは、TikTokが公開している間はランキングページに表示され、公開が止まると消えます。

リセット時刻は、その地域でTikTokのボードが最もよく切り替わる時刻で、私たち自身の取得履歴から算出しています。地域ページには、取得できている場合はTikTokが公開しているリアルタイムのカウントダウンを表示しています。

各プランでマスクされる内容とその理由

スコア、順位、件数がマスクされることはありません。すべての行に本当の順位とダイヤモンドが表示されるため、合計と順位はどのプランでも正確です。プランによって変わるのは、行にクリエイターやギフターの名前が表示されるかどうかです。マスクされた名前は、ドットのあとに末尾の数文字が続く形で表示されます。

マスクする理由: 数値は公開情報であり、これからも公開のままです。しかし、名前の完全なリスト、とりわけ今配信中の人のリストは、クリエイターの引き抜きやデータの転売のために無料表示から大量に抜き出されやすい情報です。マスクすることで、ボードを読む価値は保ちつつ、大量の個人特定データは責任の所在が明確な有料プランに結び付けています。プランと料金: 料金。

保存している履歴の期間

• クリエイターページ - 過去90日間のランキング履歴。
• クリエイターのダイヤモンド履歴（Agency） - 過去12か月。
• ギフターページ - 直近90日間。個々のギフトイベントは約3か月間保存。
• ギフターボード - 日間、週間、月間の期間。
• ゲーミングの順位変動 - 過去2時間から過去3日間までの期間。
• 日間ボード - 現在のランキング日をリアルタイムで表示し、各地域ページに最近の日間トップも掲載。
• リーグのディビジョン - 現在の週間の期間。

既知のカバー漏れ

• 利用不可と表示されるボード。 APIがボードに対してavailable: falseを返す場合、その地域と期間には使えるデータがありません。これはカバー範囲の欠けであり、その地域にランキング入りしたクリエイターがいないという意味ではありません。たとえばゲーミングボードは、すべての地域で利用できるわけではありません。
• 毎時ボードのみの地域。 トルコと中東・アフリカにはTikTokの日間ボードがないため、「日間」表示は現在の毎時ボードになります。
• 日間ボードのアーカイブページ。 過去の日間ボードの日付別アーカイブページは、すべての地域と日付で公開しているわけではありません。過去の日付に行が表示されない場合は、その日の公開スナップショットがないという意味で、誰もランクインしなかったという意味ではありません。
• 空のディビジョン。 ランキング入りしたクリエイターがいないリーグのディビジョンは掲載していません。また、TikTokがメンバーを入れ替えたディビジョンは、取得のたびに変わることがあります。
• 一時的な障害。 TikTokがしばらく応答しなくなった場合、ボードは最後に正常に取得したデータを保持し、取得時刻は更新されなくなります。数値を使う前に取得時刻を確認してください。

数値を引用する前に

• ボード上のダイヤモンドは、取得時点でTikTokが表示していたスコアで、現在のランキング日（日間ボード）、ランキング週（リーグのディビジョン）、ランキング時間（毎時ボード）のものです。
• 収益・売上の数値は、ダイヤモンドから算出した推定値です。支払額ではありません。クリエイターが実際に受け取る額は、TikTokとエージェンシーの条件によって決まります。
• マスクされた行は名前を隠した本物の行です。合計や順位には含めて数え、欠けているものとして扱わないでください。
• 地域はTikTokのランキングプールであり、居住国ではありません。ある国の「出身」ではなく、「北米地域でランクイン」と書いてください。
• 取得時刻: ページまたはAPIレスポンスに表示された時刻を、できればUTCで記載してください。
• WebSocket APIでは90+種類のLIVEイベントを公開しています。詳しくはAPIドキュメントをご覧ください。

データの問題を報告

数値がおかしいと思ったら、ページのURLまたはAPIリクエスト、地域、確認した時刻（タイムゾーン付き）、本来表示されるべきだと思う内容を[email protected]までメールでお知らせください。同じ時刻にTikTokアプリで同じボードを撮ったスクリーンショットがあると、最も早く確認して修正できます。プライバシーに関するご依頼はプライバシーポリシーをご覧ください。