tiktok/
live-ranking

Pull TikTok's LIVE daily creator ranking with one TikTok Live Ranking API call: up to 99 hosts with rank, gift-based score, user ID, handle, display name, follower count and profile link.

TikTok Live Ranking API

No input needed
Up to 99 hosts
Gift-based score
0.5 credits / request
Ready
Ready

Send the empty request. The task status and normalized results will appear here.

README

By SocQ · Updated

TikTok Live Ranking

TikTok's LIVE daily ranking is the day's leaderboard of live hosts, ordered by a score that comes from the gifts viewers send during their broadcasts, with each entry showing the host's position, score and follower count. Reading it shows which hosts viewers are backing today, how the top places move, and which smaller accounts earn more support than their audience size would suggest.

TikTok Live Ranking API Features

  • The whole board, no parametersA request takes no input and returns the current daily ranking with up to 99 hosts, each carrying its rank.
  • Score beside audience sizescore is the gift-based ranking value and followers_count the host's follower total, so support and audience can be compared without a second lookup.
  • Host identity on every rowauthor gives the host's user ID, handle, display name, profile link and avatar.

TikTok Live Ranking API Parameters

Ready to send

This endpoint does not require request parameters. Send the empty JSON object as-is.

{}

How to Use the TikTok Live Ranking API

Submit an empty request to the TikTok Live Ranking API and read the ranked hosts.

  1. POST {} to /v1/tiktok/live-ranking.
  2. Poll GET /v1/tasks/{task_id} until status is succeeded.
  3. Read hosts from results.items and pass results.next_cursor back while has_more is true.
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 Use Cases

  • Tracking the board through the day: Call the TikTok Live Ranking API at fixed hours and plot each host's rank and score to see who climbs and when the order changes.
  • Scouting hosts for agencies and sponsors: Divide score by followers_count to find hosts whose viewers give a lot relative to audience size, then shortlist them for signing or sponsorship.

TikTok Live Ranking API Pro Tips

  • Schedule TikTok Live Ranking API pulls at the same time every day, because a score read at noon and one read at midnight cover different parts of the same day.
  • The ranking carries no live status. Match hosts on author.id and send their usernames to TikTok User Live to see who is broadcasting now.

Beyond the TikTok Live Ranking API, use these APIs when you need a different type of public TikTok data.

  • TikTok Profiles API — Retrieve public profile identity, biographies, account flags, and audience counts by username.
  • TikTok Followers List API — Collect normalized profiles visible in public follower lists, with retained source context and supported metrics.
  • TikTok Following List API — Collect public profiles followed by TikTok accounts with normalized identity, biographies, visible metrics, and source-account context.
  • TikTok User Live API — Check usernames for live or offline status and available live-room details.
  • TikTok Audience Demographics API — See which countries a creator's followers come from, by username, with each country's share of the audience.
  • TikTok Live Search API — Find LIVE streams on air now by keyword, with hosts, titles, and current viewers.

Explore other platforms

Combine TikTok data with public data from other supported social platforms.

TikTok Live Ranking API — FAQ

TikTok Live Ranking API is a programmatic interface for reading TikTok's LIVE daily creator ranking, which needs no input. It returns up to 99 hosts, each with rank, gift-based score, user ID, handle, display name and follower count.

score is the value TikTok ranks hosts by today, based on the gifts their streams received. It is a ranking score, not a payout in any currency.

Not with this endpoint. It takes no input and returns the current daily ranking, so keep your own saved copies if you need history.

Positions move as gifts arrive during the day. A pull is a flat 0.5 credits for the whole board, so an hourly schedule costs 12 credits a day.

No. It ranks the hosts who received them, with each host's rank, score and profile, and has no list of gifters.