TikTok Live Scraper - Search, Status, Rankings & Gifters
Pricing
from $6.52 / 1,000 live rooms
TikTok Live Scraper - Search, Status, Rankings & Gifters
Scrape TikTok LIVE: search live rooms by keyword, check whether creators or rooms are live right now with viewers and host stats, read the daily ranking of top live creators and the top gifters of a live room. No login or cookies needed. Export JSON, CSV or Excel.
Pricing
from $6.52 / 1,000 live rooms
Rating
0.0
(0)
Developer
Silkline
Maintained by CommunityActor stats
0
Bookmarked
13
Total users
4
Monthly active users
3 days ago
Last modified
Categories
Features
Share
You put in: {"mode": "liveSearch", "keywords": ["cat"], "region": "US", "maxResults": 10}
You get back: one record per live room with 17 fields. Three records from a real run on 2026-10-22, some of the fields:
title | viewerCount | totalViewers | likeCount |
|---|---|---|---|
| CAT’S CORNER | 9 | 553 | 13375 |
| LIVE w Pandy at Night #cat | 7 | 747 | 4550 |
| CAT MODE ON Restock Day | 102 | 15619 | 12973 |
You pay: 40 live rooms for one keyword cost $0.336 on the Bronze plan. Free Apify accounts get 2 trial runs of up to 10 results each, nothing charged.
This TikTok LIVE scraper works without a login: search live rooms by keyword, check whether creators or rooms are live right now, read the daily ranking of top live creators and see the TikTok gifters at the top of a live room's gifter ranking. Built for live-commerce research, creator scouting, agency monitoring and alerts when a creator goes live.
What is TikTok LIVE data?
TikTok LIVE is TikTok's live-streaming section. Every live room shows a title, the host, how many people watch, and a ranking of the viewers who send gifts. This Actor is not affiliated with TikTok; it reads what anyone sees on a live room or in the live rankings and returns it as flat records.
What data can you get?
| Mode | What it returns |
|---|---|
liveSearch | Live rooms found by keyword: title, viewers now, total viewers, likes, start time, host handle, nickname and follower count, link to the live |
liveStatus | One record per user or room you give: live or offline, and when live the room's title, viewers, start time and host stats. Users are looked up by handle or link, rooms by ID (checked in batches) |
liveRanking | The daily ranking of top live creators, up to 99 rows: rank, creator, followers and the day's score. Today so far or the ranking of yesterday |
liveGifters | The top of a live room's gifter ranking (up to 30 people, often fewer): rank, public user ID, handle, nickname, picture and the coins sent |
Live room records (type: liveRoom): roomId, title, isLive, viewerCount, totalViewers, likeCount, shareCount, startedAt, coverUrl, hostUserId, hostHandle, hostNickname, hostFollowerCount, hostFollowingCount, liveUrl, keyword.
Status records (type: liveStatus): input, status (live or offline), isLive, roomId, title, viewerCount, totalViewers, startedAt, coverUrl, hostUserId, hostHandle, hostNickname, hostVerified, hostFollowerCount, hostFollowingCount, hostAvatarUrl, liveUrl. An offline user keeps the host fields and has empty room fields. A room checked by ID has only status and roomId unless you switch on includeRoomInfo.
Ranking rows (type: liveRankEntry): day, rank, userId, handle, nickname, avatarUrl, followerCount, score, scoreText.
Gifter rows (type: liveGifter): roomId, hostUserId, hostHandle, rank, score, userId, handle, nickname, avatarUrl.
How to use TikTok Live Scraper
- Open the Actor and choose a mode.
- Fill the fields that belong to the mode (keywords, users, room IDs, ranking day); every field is named after its mode in the form.
- Set the maximum number of results and run.
- Export the dataset as JSON, CSV or Excel, or read it through the API.
Input
| Field | Type | Mode | Meaning |
|---|---|---|---|
mode | string | all | One of the four modes. Default liveSearch |
keywords | list | liveSearch | Each keyword is a separate search and pays its own start fee |
region | string | liveSearch | Two-letter country code of the search. Default US |
users | list | liveStatus, liveGifters | Handles (@name or name), profile links or live links (https://www.tiktok.com/@name/live). Short links are not supported |
roomIds | list | liveStatus, liveGifters | Live room IDs, 15 to 20 digits (the roomId of a result) |
includeRoomInfo | boolean | liveStatus | Add title, viewers, likes, start time and host data to every live room given by ID (one more request per live room) |
rankDay | string | liveRanking | today (so far) or yesterday. Default today |
maxResults | integer | all | Per keyword (liveSearch), per room (liveGifters), the number of users and rooms checked (liveStatus), the rows (liveRanking). Up to 1000. Default 20 |
{"mode": "liveSearch", "keywords": ["cat"], "region": "US", "maxResults": 40}
{"mode": "liveStatus", "users": ["@anonymomma69", "https://www.tiktok.com/@khaby.lame/live"], "maxResults": 20}
Output example
{"type": "liveRoom", "roomId": "7699295919586167566", "title": "Oh Look A Stray Cat!", "isLive": true, "viewerCount": 6,"totalViewers": 1850, "likeCount": 75521, "shareCount": 20, "startedAt": "2026-10-22T01:21:44Z","hostUserId": "6744203391544607750", "hostHandle": "anonymomma69", "hostNickname": "Sweet Like Sugar","hostFollowerCount": 1240, "hostFollowingCount": 279, "liveUrl": "https://www.tiktok.com/@anonymomma69/live", "keyword": "cat"}
{"type": "liveRankEntry", "day": "today", "rank": 1, "userId": "6758816569066963973", "handle": "tyler_river","nickname": "Tyler River", "followerCount": 866591, "score": 601257, "scoreText": "601.2K"}
How much does it cost?
You pay per event: a start fee per run, plus a fee per record returned. Prices are in USD and depend on your Apify plan tier.
| Event | Bronze | Silver | Gold, Platinum, Diamond |
|---|---|---|---|
| Start fee, per run | $0.016 | $0.016 | $0.016 |
Live room (liveSearch) or status record (liveStatus) | $0.008 | $0.007217 | $0.006522 |
Ranking row (liveRanking) | $0.002 | $0.001804 | $0.00163 |
Gifter row (liveGifters) | $0.001 | $0.000902 | $0.000815 |
The examples below use Bronze prices.
- Keyword search pays the start fee again for every further keyword. In
liveGiftersevery further room or user pays it again too, because each one needs its own lookups.liveStatusandliveRankingpay one start fee per run. - Example: 40 live rooms for one keyword cost $0.016 + 40 x $0.008 = $0.336.
- Example: the status of 50 creators costs $0.016 + 50 x $0.008 = $0.416.
- Example: the full daily ranking (99 rows) costs $0.016 + 99 x $0.002 = $0.214.
- Example: a full gifter ranking of 30 people costs $0.016 + 30 x $0.001 = $0.046; rooms often return fewer.
- A spending limit set on the run is respected: the run stops cleanly when the next record or start fee does not fit.
On the free Apify plan you get 2 free trial runs of this Actor with your own input, up to 10 results each, and nothing is charged; after that, runs return a stored sample dataset (a real result of the prefilled input). Use any paid Apify plan for full runs.
Use cases
- Find live rooms about a product, game or topic and see how many people watch.
- Check a list of creators every few minutes and react when they go live (schedule the Actor).
- Scout creators for live commerce and agency work with the daily ranking and their follower counts.
- Watch who gifts the most in the lives of a creator you work with or compete against.
Integrations and API
Runs can be started through the Apify API, scheduled, and connected to integrations such as webhooks, Zapier or Make.
from apify_client import ApifyClientclient = ApifyClient("<YOUR_APIFY_TOKEN>")run = client.actor("clover_folktale/tiktok-live-scraper").call(run_input={"mode": "liveStatus", "users": ["@anonymomma69"]})for item in client.dataset(run["defaultDatasetId"]).iterate_items():print(item["input"], item["status"], item["viewerCount"])
Tips and limits
- Unreadable entries. If one entry of an ID or link list cannot be read (a typo, a stray cell, a link to the wrong kind of page), it is skipped and named in the log, and the status message says how many were skipped; the other entries still run and nothing is charged for a skipped one. Only a list with no readable entry stops the run with an input error.
- Live data is a snapshot of the moment of the run: viewers, likes and the live flag change every minute.
- Search returns 16 to 20 rooms per page and goes on while pages bring rooms you do not have yet. TikTok fills a search with other live rooms when few rooms match, so check the titles.
- Region
USsearches may be served by an alternate search path (it cannot take a region and returns US rooms). For any other region such a search ends with no rooms delivered, so you never get US rooms for a GB search. Run again later. - A user who is not live is a normal result (
status: offline). A user who does not exist gives no record. Once a run has delivered records, further missing inputs are skipped and the run goes on. A handle the platform rejects counts as a missing user. - A room given by ID can only be told live or offline. Switch on
includeRoomInfoto get its title, viewers and host. - The daily ranking cannot be narrowed by region; it is the list TikTok serves by default. The hourly, weekly and rookie rankings returned nothing in tests and are not offered.
- The gifter ranking is TikTok's list of top viewers of the room: it starts with the people who sent gifts and may continue with viewers whose
scoreis 0. A user must be live forliveGifters; a room that has ended or is unknown gives no rows. - Only what the live room shows publicly is returned: handles, nicknames, public IDs, pictures, ranks and scores. No private data.
- Picture addresses are temporary; download what you need soon after the run.
- The first start fee is charged once the platform has answered; an empty answer counts.
FAQ
Do I need a TikTok account? No login or cookies are needed.
Is it legal? Only public data is returned. No messages, phone numbers or other private data. You are responsible for how you use it.
How fresh is the data? Each run reads the platform at that moment.
Can I see the chat or watch the stream? No. The Actor returns room and ranking data, not chat messages or video streams.
Can I schedule runs and export? Yes, to JSON, CSV, Excel and more.
Other tools by Silkline
Every tool below charges per result and needs no login or cookies.
Global platforms
- TikTok Scraper - Video Search, Hashtags, Profiles & Sounds
- YouTube Shorts Scraper - Search, Channel Shorts & Videos
- Instagram Scraper - Posts, Reels, Profiles & Followers
- Reddit Scraper - Posts, Comments, Subreddits & Users
- Threads Scraper (Meta) - Posts, Replies, Profiles & Search
- Telegram Channel Scraper - Messages, Search & Subscribers
- IMDb Scraper - Top 250 Movies & TV Shows Chart, Ratings
More from Silkline
- Xiaohongshu 小红书 RedNote Scraper - Notes, Comments & Replies (Chinese social media and content)
- Taobao Tmall 淘宝 Product Scraper - Prices, Sales & Shops (E-commerce)
- Douyin Xingtu 巨量星图 KOL Scraper - Rates, CPM & Rankings (Marketing and creator data)