TikTok Live Search Scraper

🔎 Find active TikTok LIVE rooms by topic

Social media researchers, creator teams, and live trend trackers can use this Actor to search public TikTok LIVE rooms by keyword. It saves one dataset row for each distinct room, with room, creator, audience, engagement, media, and source details. Use the rows to compare active rooms, review live topics, or send structured data to another workflow.

• Search live Shop rooms to inspect active shopping streams.
• Find active Fitness rooms for creator and topic research.
• Browse Music rooms and collect public live-room details.
• Track public Football rooms and their audience counts.
• Discover active Makeup rooms with creator and engagement data.
• Find Gaming rooms with ranks, titles, viewer counts, and stream links.

📦 TikTok LIVE room data

Each row covers the first eligible occurrence of one distinct active room found for a keyword. A later match for the same room is not saved again. The fields below keep the keyword, rank, room, creator, audience, media, stream, and source details that TikTok exposes.

▶️ Search TikTok LIVE rooms

1. Enter one or more topics in keywords.
2. Set maxResultsPerKeyword if you want a per-keyword cap. Leave it empty to return all available rooms until the source is exhausted.
3. Start the Actor and open the dataset.
4. Export the rows or use them through the Apify API, schedules, webhooks, or integrations.

You do not need to provide TikTok cookies, a TikTok login, or a TikTok API key. For a small first run, keep the prefilled gaming keyword and use a small room limit. Good topics include gaming, makeup, football, music, fitness, shop, or another creator niche.

This Actor searches TikTok LIVE rooms only. It does not discover followers, scrape regular TikTok video search, monitor one room in real time, collect live chat, or record or save broadcast video files.

⚙️ Input

Input fields

Field	Type	What it does
keywords	array of strings	Searches each keyword separately. Use 1 to 100 unique, non-empty values.
maxResultsPerKeyword	integer	Sets the maximum number of distinct rooms to save for each keyword. Use 1 or more. Leave it empty to return all available rooms until the source is exhausted. The source may return fewer rooms than this cap.

Example input

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

🧾 Output

Dataset row fields

Field	Type	What it does
keyword	string	The keyword that found and saved this room.
rank	integer	The room's one-based position among distinct results for this keyword. Rank starts at 1 for each keyword.
roomId	string	The stable TikTok identifier for the live room.
isLive	boolean	Says whether the source marks the room as live.
title	string or null	The title shown for the live room, when available.
startedAt	date-time or null	When the live room started, when available.
creatorHandle	string or null	The broadcaster's public TikTok handle, when available.
creatorNickname	string or null	The broadcaster's public display name, when available.
creatorProfileUrl	URL or null	A link to the broadcaster's public TikTok profile.
creatorAvatarUrl	URL or null	A link to the broadcaster's profile image.
creatorBio	string or null	The broadcaster's public profile bio.
creatorFollowerCount	integer or null	The broadcaster's public follower count.
viewerCount	integer or null	The viewer count shown for the live room.
totalAudienceCount	integer or null	The total audience count shown by the source, when available.
likeCount	integer or null	The number of likes shown for the live room.
shareCount	integer or null	The number of shares shown for the live room.
commentCount	integer or null	The number of comments shown for the live room.
categoryName	string or null	The live category shown for the room.
gameTags	array of strings	Game or topic tags shown for the live room.
coverImageUrl	URL or null	A link to the live room cover image.
snapshotImageUrl	URL or null	A link to an image snapshot from the live room.
streamUrls	array of objects	Available live stream URL variants and their source details.
streamUrls[].url	URL	The live stream URL.
streamUrls[].protocol	string	The protocol used by the stream URL.
streamUrls[].quality	string or null	The stream quality label, when available.
streamUrls[].expiresAt	date-time or null	When the source says the stream URL expires.
sourceUrl	URL or null	A link to the TikTok live room source page.
scrapedAt	date-time or null	When this room result was collected.

Complete example row

This is one complete row from a successful current-beta run for gaming.

{
  "keyword": "gaming",
  "rank": 1,
  "roomId": "7677965182118677262",
  "sourceUrl": "https://www.tiktok.com/search/live?q=gaming",
  "scrapedAt": "2026-08-25T17:53:14.451Z",
  "isLive": true,
  "title": "#1 WARZONE COACH!",
  "startedAt": "2026-08-25T13:48:37.000Z",
  "creatorHandle": "blessed_brinsongaming",
  "creatorNickname": "BB GAMING",
  "creatorProfileUrl": "https://www.tiktok.com/@blessed_brinsongaming",
  "creatorBio": "GOD, LOVE, TOGETHERNESS ❤️ TOP 250 WARZONE PLAYER🏕️",
  "creatorAvatarUrl": "https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/52392d643c951564fbb684af6522bd27~tplv-tiktokx-cropcenter:720:720.webp?dr=10399&refresh_token=8eee074f&x-expires=1787850000&x-signature=D29gY%2BYQ1VY6cWqz9pr4HcLop%2Bs%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=fdd36af4&idc=no1a",
  "creatorFollowerCount": 218794,
  "viewerCount": 709,
  "totalAudienceCount": 27308,
  "likeCount": 34503,
  "shareCount": 27,
  "commentCount": 3882,
  "categoryName": "Gaming",
  "gameTags": [
    "Call of Duty: Black Ops 7"
  ],
  "coverImageUrl": "https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/52392d643c951564fbb684af6522bd27~tplv-tiktokx-cropcenter:720:720.webp?dr=10399&refresh_token=8eee074f&x-expires=1787850000&x-signature=D29gY%2BYQ1VY6cWqz9pr4HcLop%2Bs%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=fdd36af4&idc=no1a",
  "snapshotImageUrl": "https://p19-common-sign.tiktokcdn-eu.com/tos-useast5-i-vo4twfpge7-tx/3f5c3bc93824419fb33b03726df2910b~tplv-vo4twfpge7-pc-cover-withface:540:960:1.webp?dr=10375&refresh_token=295e8b3f&x-expires=1787698800&x-signature=s%2BeCAn6owddy9zvNYd43wGBsnKg%3D&t=4d5b0474&ps=13740610&shp=7f1bcd8d&shcp=97fb53a0&idc=no1a&ftpl=1",
  "streamUrls": [
    {
      "protocol": "rtmp",
      "url": "https://pull-f5-tt01.fcdn.eu.tiktokcdn.com/game/stream-3578732727689806780_hd.flv?expire=1788889994&sign=10d6a49a02ed23e01458aef0f32635d6",
      "quality": "default",
      "expiresAt": "2026-09-08T17:53:14.000Z"
    },
    {
      "protocol": "flv",
      "url": "https://pull-f5-tt01.fcdn.eu.tiktokcdn.com/game/stream-3578732727689806780_hd.flv?expire=1788889994&sign=10d6a49a02ed23e01458aef0f32635d6",
      "quality": "HD1",
      "expiresAt": "2026-09-08T17:53:14.000Z"
    },
    {
      "protocol": "flv",
      "url": "https://pull-f5-tt01.fcdn.eu.tiktokcdn.com/game/stream-3578732727689806780.flv?expire=1788889994&sign=ffa967158d336d4e821329577a4769e5&only_audio=1",
      "quality": "ao",
      "expiresAt": "2026-09-08T17:53:14.000Z"
    },
    {
      "protocol": "cmaf",
      "url": "https://pull-f5-tt01.fcdn.eu.tiktokcdn.com/game/stream-3578732727689806780_ao/index.mpd?expire=1788889994&sign=43e709d13ffd21f7afdbab927f6e84a8",
      "quality": "ao",
      "expiresAt": "2026-09-08T17:53:14.000Z"
    },
    {
      "protocol": "flv",
      "url": "https://pull-f5-tt01.fcdn.eu.tiktokcdn.com/game/stream-3578732727689806780_hd.flv?expire=1788889994&sign=10d6a49a02ed23e01458aef0f32635d6",
      "quality": "hd",
      "expiresAt": "2026-09-08T17:53:14.000Z"
    },
    {
      "protocol": "hls",
      "url": "https://pull-hls-f16-tt01.tiktokcdn-eu.com/game/stream-3578732727689806780_hd/index.m3u8?expire=1788889994&sign=02e5fa0cbf07ac0210cb6e966ea43110",
      "quality": "hd",
      "expiresAt": "2026-09-08T17:53:14.000Z"
    },
    {
      "protocol": "cmaf",
      "url": "https://pull-f5-tt01.fcdn.eu.tiktokcdn.com/game/stream-3578732727689806780_hd/index.mpd?expire=1788889994&sign=565832251080824a946ecdc081ee9728",
      "quality": "hd",
      "expiresAt": "2026-09-08T17:53:14.000Z"
    }
  ]
}

Optional values can be null or absent when TikTok does not expose them. Stream URLs can be temporary and may expire after the run.

💳 Pricing

This Actor uses pay-per-event pricing. Each saved live room creates one Live room event at $0.00445, or $4.45 per 1,000 saved live rooms. A keyword with no accepted live room creates no live-room event. The maxResultsPerKeyword cap can limit the number of charged room events.

Limits and caveats

TikTok LIVE search changes throughout the day. A keyword can return fewer rooms than its cap when the source has fewer active rooms, duplicate appearances are ignored, or a room stops being available during the run.

The Actor saves active live rooms returned by TikTok LIVE search during the run. It does not promise complete coverage of every active TikTok live stream, and it does not keep watching rooms after they are found.

🔌 Integrations

Open the dataset in Apify and export rows as JSON, CSV, Excel, XML, RSS, or HTML. Call the run or dataset through the Apify API, schedule repeat checks, or send rows to webhooks and integrations.

❓ FAQ

How are ranks assigned for each keyword?

Rank is the one-based position of each distinct saved room in that keyword's source results. It starts at 1 again for every keyword.

What happens if the same room matches more than one keyword?

Only the first eligible occurrence is saved. Later matches are ignored, so the dataset does not repeat that room.

Why did I get fewer rows than the limit?

The limit is a cap, not a guarantee. TikTok may return fewer active rooms for a keyword, or a room may disappear while the Actor is running.

Can I use a stream URL later?

Stream URLs come from TikTok and can expire after the run. Use them soon after collection when you need to process them.

Can I use this for repeat monitoring?

Yes. Schedule the Actor on Apify with the same keyword list to collect fresh active LIVE search results over time.

Does this collect live chat or record broadcasts?

No. The Actor returns public room data and stream URLs when TikTok exposes them. It does not collect live chat, record broadcasts, or save video files into storage.

Do I need a TikTok account?

No. The Actor runs without your TikTok login, cookies, or a TikTok API key.

📝 Changelog

1.0: Distinct live rooms now keep sequential per-keyword ranks

• Distinct rooms receive one-based ranks that restart for each keyword.

v0.1

• Initial release.

🆘 Support

For issues, questions, or feature requests, file a ticket and I'll fix or implement it in less than 24h 🫡

🔗 Related Actors

• TikTok Keywords Discovery Tool - Find TikTok autocomplete keyword suggestions before choosing live-room search terms.
• TikTok Hashtag Search Scraper - Find TikTok hashtag ideas and public hashtag metrics from keywords.
• TikTok Profile Mention Scraper - Find public TikTok videos that mention selected profile handles.
• TikTok Story Viewer - View active public TikTok stories from usernames, handles, or profile URLs.
• TikTok Video Downloader - Get direct media links and public metadata from known TikTok video URLs.

Made with ❤️ by Maxime Dupré