TikTok Leaderboard API: Daily and Weekly Top Creators by Country
How to pull TikTok's daily diamond leaderboard and its weekly league standings as JSON, country by country, and why the two boards answer different recruiting questions.
TikTok ranks LIVE creators in two different ways, and if you recruit from those rankings it pays to know which one you are reading. One is the daily board: the highest diamond earners in a country today, which resets and reorders through the day. The other is the weekly league board: divisions where creators accumulate a score across the league cycle and fight for placement. Both are useful, both are tied to a country, and neither has an official TikTok endpoint. This guide explains the difference and shows how to pull each one as data, country by country.
Daily and weekly answer different questions
The daily leaderboard answers "who is earning right now". It is a rolling top list of the biggest diamond earners in a country for the current day, and because it moves with every stream it is the board you watch for live momentum. A creator near the top of today's board is having a good day, which is useful but also noisy: tomorrow the names can look different.
The weekly league board answers "who is consistently strong". League divisions group creators and rank them by a score built up over the league cycle, so the board rewards creators who show up and earn across days rather than one lucky session. If you want a stable shortlist of serious creators in a market, read the league boards. If you want to catch who is hot this afternoon, read the daily board. Most recruiting teams use both: the weekly board for who to target, the daily board for when to reach out.
Pulling the daily top creators for a country
Since there is no public TikTok leaderboard endpoint, the boards come from providers who capture the standings continuously. The RnG API serves the same boards the dashboard uses. The daily ranking for a country is one request:
curl "https://rngrow.com/api/v1/leagues/daily?country=RO" \
-H "X-API-Key: rng_live_YOUR_KEY"Each row carries the rank, the creator's handle and nickname, their diamonds for the day, follower count, whether they were live at capture, and whether they can currently be recruited. The board also reports its own age in minutes, so your code can tell a snapshot from nine minutes ago from one that is stale. For most countries the daily board is a true daily total; for the MENA markets it refreshes hourly, so read the board age rather than assuming a fixed cadence.
Pulling the weekly league standings
The weekly side is two calls. First list the divisions a country has, along with how fresh each board is:
curl "https://rngrow.com/api/v1/leagues?country=RO" \
-H "X-API-Key: rng_live_YOUR_KEY"That returns the division ids for the country, such as A1, B3 or D5, with a capture time and age for each. You never hardcode the division list, because coverage changes; you enumerate it and then fetch the boards you want. A single division board is the next call:
curl "https://rngrow.com/api/v1/leagues/board?country=RO&division=A1" \
-H "X-API-Key: rng_live_YOUR_KEY"A division board is the top of that bracket ranked by score, with the same per-creator fields as the daily board plus the league score itself. Where the daily board uses diamonds earned today, the league board uses the running score, which is the number that decides weekly placement.
What each row actually tells you
- Score or diamonds. The daily board ranks by diamonds for the day; the league board ranks by the accumulated league score. Do not compare the two numbers directly, because they measure different windows.
- Was live at capture. A live flag is only meaningful while the capture is recent. Read it together with the board age, and treat it as unknown once the board is old.
- Recruit status. Whether a ranked creator can currently be invited is half the value of a leaderboard. A top earner you cannot sign is interesting but not actionable, so filter on this before you spend a recruiter's time.
- Check age. Each row says how many minutes ago its recruitability was verified. A fresh check means you are not about to message someone who is already being re-checked or has just been signed elsewhere.
From leaderboard to a working shortlist
A rank on its own is a vanity number. The reason to pull these boards is to turn them into a list your recruiters can work, which means combining the ranking with availability. You can filter the daily or league rows to only the recruitable creators, or pull the whole ladder at once as JSON or ready-to-open CSV and hand it to whoever runs outreach. Keeping country as the top-level filter matters here: a creator who ranks in one market is not necessarily recruitable in another, and your messaging, language and timing all change by country.
A simple daily routine works well. Each morning, pull the weekly league boards for your countries to decide who is worth targeting, then watch the daily board through the day to catch the right moment to reach out, which is usually while a creator is mid-stream and climbing. The weekly board gives you the names; the daily board gives you the timing.
What to check in any leaderboard data source
- A capture time on every board. Rankings move constantly, so a board with no age cannot be trusted for any time-sensitive decision.
- Live flags that expire. A good source withholds or ignores the live flag once the board is stale instead of letting a two-hour-old flag read as current.
- Eligibility attached to the row. Rank plus recruitability in one place beats a ranking you then have to check creator by creator.
- Coverage you can enumerate. You should be able to list which countries and divisions exist from the API, not guess them.
The takeaway
Daily and weekly leaderboards are the closest thing TikTok has to a public scoreboard of who matters in each market, but they are not the same board and they do not answer the same question. Read the daily board for momentum and the weekly league board for consistency, keep country as your first filter, and insist on a capture time, an expiring live flag and eligibility on every row. Pull both, and recruiting turns from cold search into working a ranked, available and freshly verified list.