Methodology
Data methodology
Every number in RoomScope comes with its provenance so you can judge how fresh and how complete it is.
Coverage follows what can be observed sustainably
We watch a bounded, expanding set of public LIVE rooms and creators. Results show what was observed in that set, never a claim about all of TikTok.
Public signals and explicit limits
Reads come from stored observations; a refresh queues work in the background instead of calling TikTok on your request. Rate limits and allowances are published per plan.
Observed boards and our own calculations stay separate
Official observed leaderboards reproduce a TikTok board and are published only after coverage passes a gate. Derived rankings and gifter totals are our calculations and are always labelled as such.
Retention is capped and suppression is durable
LIVE history is kept for a bounded period. A creator opt-out or deletion request removes retained history and stops further collection.
Provenance on every result
- Source
- The observed dataset or collector that produced the record.
- Observed at
- When the public signal was captured, not when the page was opened.
- Freshness
- Whether the stored observation is near realtime, historical or delayed.
- Coverage status
- Where the result sits relative to what we observe. It is never a completeness guarantee.
- Methodology version
- The versioned calculation used, so derived results can be traced.
Time windows and resets
Every result names the window it covers (provenance.window: from, to and a label such as daily, 24h or 30d). An official board covers its ranking period and ends at the next TikTok reset (resetAt); history and analytics windows follow your plan’s history length. A number outside its window is not a number for that window.
Empty is not 0
When nothing was observed for a creator, a day or a board, we show “—” and observedAt: null with coverage not-covered, never 0 and never “just now”. A 0 means we observed it and the count was zero.
Official or derived
sourceKind: official marks a number TikTok publishes itself (rank boards, shown as “Official · TikTok”). derived marks what RoomScope observed, counted or computed (LIVE sessions, gifters, analytics, pulse), shown as “Derived · RoomScope”.
Methodology versions in use
Each result carries the version of the calculation behind it. Coverage gates are reported as published here (rankings: a region publishes when complete boards reach the coverage threshold); they are not enforced per region yet.
rankings-official-v1- Official TikTok boards as observed at each crawl; published from a complete snapshot.
live-history-v1- Recorded LIVE sessions and their gift and gifter rollups.
creators-v1- Stored public creator profiles and their changes.
creator-analytics-v1- Daily creator analytics: TikTok score where TikTok shows one, observed coins otherwise.
gifters-observed-v1- Gifter totals from the rooms we recorded only.
pulse-v1- System-wide counters on the home page, recomputed every minute.
Coverage status values
observed- A matching stored observation is inside the current coverage set.
partial- Some usable data exists, but the observation or the requested window is incomplete.
not-covered- No matching stored observation exists in the coverage set yet.
stale- The newest matching observation is older than the published freshness threshold.
RoomScope is an independent product. It is not affiliated with, endorsed by or sponsored by TikTok or ByteDance.