TikTok Live Search Scraper

TikTok Live Search Scraper

TikTok Live Search Scraper finds TikTok LIVE rooms that are broadcasting right now for any keyword and returns each room's title, streamer, current viewers, total audience, likes, shares, comments, category, game tags, images, and playable live stream URLs.

Search up to 100 topics per run, such as gaming, makeup, football, or music, and get ranked LIVE rooms with streamer follower counts, audience stats, and FLV, HLS, and CMAF stream links, without a TikTok login.

ParseBird TikTok Suite   •  Video, story, LIVE & shop data
TikTok Slideshow Downloader Photo-mode posts as image files	TikTok Story Viewer Active stories, no-watermark video	TikTok Live Search Scraper You are here	TikTok Shop Reviews Scraper Product reviews and ratings

Copy to your AI assistant

Copy this block into ChatGPT, Claude, Cursor, or any LLM to start using this actor.

Use Apify Actor parsebird/tiktok-live-search-scraper to search TikTok LIVE rooms that are broadcasting now. Example with ApifyClient (Python): client.actor("parsebird/tiktok-live-search-scraper").call(run_input={"keywords":["gaming","makeup"],"maxResultsPerKeyword":5}). Inputs: keywords array of strings required (1-100 unique topics, each searched separately); maxResultsPerKeyword integer optional (empty = every room TikTok returns, typically a few dozen per keyword). Output: one row per room with keyword, rank (1-based per keyword), roomId, sourceUrl (the room's tiktok.com/@handle/live page), isLive, title, startedAt (ISO 8601), creatorHandle, creatorNickname, creatorProfileUrl, creatorAvatarUrl, creatorBio, creatorFollowerCount, viewerCount, totalAudienceCount, likeCount, shareCount, commentCount, categoryName, gameTags[], coverImageUrl, snapshotImageUrl, streamUrls[{protocol (rtmp/flv/hls/cmaf/lls), url, quality, expiresAt}]. Fields TikTok does not provide are omitted. API docs: https://docs.apify.com/api/client/python/ and https://docs.apify.com/api/client/js/. Token: https://console.apify.com/account/integrations.

What is TikTok Live Search Scraper?

TikTok Live Search Scraper is a TikTok LIVE search API alternative. Enter topics like gaming, makeup, or music, and it returns the TikTok LIVE rooms that are live right now for each keyword, in TikTok's own search order, with streamer details, audience and engagement stats, and live stream URLs you can open in a player.

You don't need TikTok cookies, a login, or an API key. The easiest way to try it is to open the actor, keep the prefilled gaming keyword with a 5-room limit, and click Start.

It searches LIVE rooms only. It does not search regular TikTok videos, monitor one room over time, collect live chat, or record broadcasts.

What can TikTok Live Search Scraper do?

• 🔴 Find live rooms by topic: one search per keyword, up to 100 keywords per run.
• 📈 Get audience stats: current viewers, total audience, likes, shares, and comments.
• 👤 Get streamer details: handle, display name, profile link, avatar, bio, and follower count.
• 🏷️ See what is being streamed: room title, LIVE category (such as Gaming or Music), and game tags (such as Fortnite or Minecraft).
• 📺 Get stream links: FLV, HLS, CMAF, and LLS URLs in several qualities, including audio-only, with their expiry time.
• 🥇 Keep TikTok's ranking with a 1-based rank per keyword, and deduplicated rooms.
• ⏱️ Track live trends by running every hour with Apify schedules.
• 🔌 Integrate with the Apify API, webhooks, and integrations such as Google Sheets, Make, Zapier, and Slack.
• 📁 Export as JSON, CSV, Excel, HTML, or XML.

What data can you extract from TikTok LIVE search?

Field	Description
keyword, rank	Keyword that found the room and its 1-based position for that keyword
roomId, sourceUrl, isLive	Room ID, link to the room's LIVE page, and whether TikTok marks it as live
title, startedAt	Room title and broadcast start time (ISO 8601, UTC)
creatorHandle, creatorNickname, creatorProfileUrl, creatorAvatarUrl, creatorBio, creatorFollowerCount	Streamer profile
viewerCount	Viewers in the room right now
totalAudienceCount	Total people who have entered the room during this broadcast
likeCount, shareCount, commentCount	Room likes, shares, and comments
categoryName, gameTags	LIVE category and game/topic tags
coverImageUrl, snapshotImageUrl	Room cover image and a snapshot of the stream
streamUrls[].protocol, url, quality, expiresAt	Live stream links (rtmp, flv, hls, cmaf, lls), quality (hd, HD1, ao = audio only), and expiry time

Fields TikTok does not provide for a room are omitted from that row, for example rooms without a title.

How to search TikTok LIVE rooms

1. Open TikTok Live Search Scraper and click Try for free or Start.
2. In Keywords, enter one topic per line, such as gaming, makeup, football, music, or fitness.
3. Optionally set Max rooms per keyword. Leave it empty to save every room TikTok returns.
4. Click Start. Each keyword takes a few seconds.
5. Open the Output tab, or export the rooms as JSON, CSV, or Excel.
6. To watch a room, open sourceUrl in a browser, or paste an hls stream URL into a player such as VLC.

Input parameters

Parameter	Type	Required	Default	Description
keywords	array of strings	Yes	—	1–100 topics. Each is searched separately; repeated keywords (ignoring case) are searched once.
maxResultsPerKeyword	integer	No	empty (all)	Maximum distinct rooms saved per keyword. The form pre-fills 5. TikTok may return fewer.
proxyConfiguration	object	No	Apify Proxy, US	Network settings; the default works for most runs

Input / Output

Example input:

{
  "keywords": ["gaming"],
  "maxResultsPerKeyword": 5
}

Example output row:

{
  "keyword": "gaming",
  "rank": 1,
  "roomId": "7690852665017797407",
  "sourceUrl": "https://www.tiktok.com/@wateryshoe/live",
  "isLive": true,
  "startedAt": "2026-09-29T07:20:44.000Z",
  "creatorHandle": "wateryshoe",
  "creatorNickname": "Watery Shoe",
  "creatorProfileUrl": "https://www.tiktok.com/@wateryshoe",
  "creatorAvatarUrl": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/7310244226543910954~tplv-tiktokx-cropcenter:720:720.webp?...",
  "creatorBio": "Nobody cares. Work harder.\nWateryshoe@gmail.com",
  "creatorFollowerCount": 1110276,
  "viewerCount": 2959,
  "totalAudienceCount": 233068,
  "likeCount": 1190773,
  "categoryName": "Gaming",
  "gameTags": ["Fortnite"],
  "coverImageUrl": "https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/7310244226543910954~tplv-tiktokx-cropcenter:720:720.webp?...",
  "snapshotImageUrl": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-i-vo4twfpge7-tx2/d6434a5be67f489d9d4f560a3f67e86c~tplv-vo4twfpge7-pc-cover-withface:540:960:1.webp?...",
  "streamUrls": [
    {
      "protocol": "flv",
      "url": "https://pull-f5-tt02.tiktokcdn-us.com/game/stream-3867164477343663054_hd.flv?expire=1791891950&sign=...",
      "quality": "hd",
      "expiresAt": "2026-10-13T11:45:50.000Z"
    },
    {
      "protocol": "hls",
      "url": "https://pull-hls-f16-tt02.tiktokcdn-us.com/game/stream-3867164477343663054_hd/index.m3u8?expire=1791891950&sign=...",
      "quality": "hd",
      "expiresAt": "2026-10-13T11:45:50.000Z"
    },
    {
      "protocol": "flv",
      "url": "https://pull-f5-tt02.tiktokcdn-us.com/game/stream-3867164477343663054.flv?expire=1791891950&sign=...&only_audio=1",
      "quality": "ao",
      "expiresAt": "2026-10-13T11:45:50.000Z"
    }
  ]
}

The real output lists every stream variant TikTok provides (rtmp, flv, hls, cmaf, lls); the example is shortened. Download results in JSON, CSV, Excel, HTML, or XML.

Python API example

from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")

run = client.actor("parsebird/tiktok-live-search-scraper").call(run_input={
    "keywords": ["gaming", "music"],
    "maxResultsPerKeyword": 10,
})

for room in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(room["keyword"], room["rank"], room.get("creatorHandle"), room.get("viewerCount"), room.get("title"))

JavaScript API example

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' });

const run = await client.actor('parsebird/tiktok-live-search-scraper').call({
    keywords: ['makeup', 'fitness'],
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
const top = items.sort((a, b) => (b.viewerCount ?? 0) - (a.viewerCount ?? 0)).slice(0, 5);
console.log(top.map((r) => `${r.creatorHandle}: ${r.viewerCount} viewers`));

See the Python client and JavaScript client docs for more options.

Use cases

• Influencer discovery: find streamers who are live in your niche right now, with follower counts and bios (which often include business emails).
• Live market research: see which games, products, and topics draw the biggest LIVE audiences.
• Brand and sponsorship scouting: shortlist creators by live viewers and engagement.
• Trend monitoring: schedule hourly runs to track how LIVE activity changes for your keywords.
• Stream monitoring tools: feed stream URLs into your own player or moderation pipeline.

How it works

1. The actor searches TikTok LIVE for each keyword, page by page, until TikTok has no more results or your limit is reached.
2. It removes repeated rooms and ranks the rest 1, 2, 3 in TikTok's order.
3. It reads room, streamer, audience, and stream details from the search results and saves one row per room.

How much does it cost to scrape TikTok LIVE rooms?

What is the price per TikTok LIVE room?

The actor uses pay-per-event pricing: you pay per room saved, and platform usage is included.

Event	Free plan	Bronze	Silver	Gold
live-room-scraped	$0.00399 ($3.99 / 1,000)	$0.00379 ($3.79 / 1,000)	$0.00359 ($3.59 / 1,000)	$0.00339 ($3.39 / 1,000)

One live-room-scraped event is one room saved to the dataset. The prefilled 5-room test costs about $0.02 on the Free plan; 1,000 rooms cost $3.99. Keywords with no live rooms are free. Apify's free plan includes monthly platform credits you can use to try the actor.

Is it legal to scrape TikTok LIVE search?

Is scraping TikTok LIVE data legal?

The actor only reads LIVE search results that TikTok shows publicly without login. Scraping public data is generally legal in many jurisdictions, but streamer profiles contain personal data (names, bios, sometimes emails) protected by laws such as GDPR and CCPA, and broadcasts are protected by copyright. Collect only what you need, respect TikTok's Terms of Service, and consult your lawyer if unsure. Read more in Apify's guide: Is web scraping legal?

Other TikTok scrapers and related Actors

Actor	Best for
TikTok Story Viewer	Active TikTok stories with no-watermark video links
TikTok Slideshow Downloader	Saving every photo from TikTok photo-mode posts
TikTok Shop Reviews Scraper	TikTok Shop product reviews and ratings
Kick Video Downloader	Kick clips and VODs

FAQ

How many rooms does one keyword return? As many as TikTok's LIVE search returns, which is usually a few dozen for popular topics (for example about 40 for gaming in our tests) and fewer for niche ones. Set maxResultsPerKeyword to cap it.

Why did a keyword return no rooms? Nobody matching that keyword was live in TikTok's search at that moment. Results change minute by minute, so try again later or use a broader keyword.

Can I watch or record the streams? The hls and flv URLs play in players such as VLC and worked without TikTok cookies in our tests, including from outside the US. They are signed and expire at expiresAt, and they stop when the broadcast ends. The actor itself does not record video.

Why are some fields missing for a room? TikTok doesn't provide every field for every room, for example a title or share count. Missing fields are left out of that row.

What is the difference between viewerCount and totalAudienceCount? viewerCount is how many people are watching now. totalAudienceCount is how many people have entered the room since the broadcast started.

Does it collect live chat or gifts? No. It collects room search results only.

Where can I report issues? Open the Issues tab on the actor page with your input and run ID.