Tiktok Live Scraper

Extract active and trending TikTok live rooms, creator info, and public audience signals for creator monitoring, event tracking, and live trend analysis.

What does this actor do?

TikTok LIVE Scraper is an Apify Actor that discovers public TikTok LIVE rooms and extracts structured, analytics-ready data for monitoring workflows, audience research, and trend analysis.

It extracts:

• Room metadata — title, status, start time, category, cover image
• Creator fields — username, display name, followers, likes, verified status, bio
• Audience/activity signals — viewer count, likes, shares, co-hosts
• Discovery qualification — priority score (0–100), audience bucket, activity bucket, monitoring bucket with human-readable explanations
• Source lineage — how each room was discovered (trending, creator, keyword)
• Run summary — aggregated statistics with top creators, top titles, and audience distribution

Discovery modes

Trending LIVE mode

Discovers hot/active live rooms using broad search terms across categories like gaming, music, chat, dance, cooking, sports, beauty, comedy, and more. Best for broad monitoring and trend detection.

Creator LIVE mode

Checks specific TikTok creators for active LIVE sessions. Accepts usernames (@creator), plain usernames, or full profile URLs (https://www.tiktok.com/@creator). Returns detailed room data when the creator is live, or a clear NOT_LIVE indicator when they're offline.

Keyword / niche LIVE mode

Searches for live rooms matching your keywords or niche topics. Useful for tracking LIVE activity in specific markets, games, or interest areas.

Mixed mode

Combine any modes in one run for comprehensive LIVE intelligence across trending, creator, and keyword sources simultaneously.

Input

Parameter	Type	Default	Description
mode	string[]	["trending"]	Discovery modes: trending, creator, keyword
creatorProfiles	string[]	[]	Creator usernames or profile URLs
keywords	string[]	[]	Keywords for niche/topic discovery
countries	string[]	[]	Country filter codes (e.g., US, AU)
maxRooms	integer	300	Max rooms per discovery source
sortBy	string	priorityScore	Sort: priorityScore, viewerCount, default
minViewerCount	integer	0	Minimum viewer count filter
includeCreatorFields	boolean	true	Include creator-level fields
includeActivitySignals	boolean	true	Include audience/activity signals
includeSummary	boolean	true	Append summary record
deduplicateRooms	boolean	true	Remove duplicate rooms
debugMode	boolean	false	Verbose logging
proxyConfiguration	object	Apify proxy	Proxy settings

Sample input: Trending discovery

Discover up to 50 trending live rooms across all categories.

{
  "mode": ["trending"],
  "maxRooms": 50,
  "sortBy": "priorityScore",
  "includeSummary": true,
  "proxyConfiguration": { "useApifyProxy": true }
}

Sample input: Creator monitoring + keyword search

Monitor specific creators for live activity while also searching for live rooms related to gaming and ASMR topics.

{
  "mode": ["creator", "keyword"],
  "creatorProfiles": [
    "https://www.tiktok.com/@aljazeera",
    "@giulianasanes",
    "elisefvc"
  ],
  "keywords": ["gaming", "asmr"],
  "maxRooms": 100,
  "sortBy": "priorityScore",
  "includeCreatorFields": true,
  "includeActivitySignals": true,
  "includeSummary": true,
  "deduplicateRooms": true,
  "proxyConfiguration": { "useApifyProxy": true }
}

Output

Each record represents one public TikTok LIVE room with a flat, CSV-friendly schema (41 fields). Results are available in four dataset views:

• Overview — combined view with key metrics and monitoring buckets
• Live Rooms — full room details with engagement and activity signals
• Creators — creator-focused view with follower/like data
• Monitoring — qualification view with priority scores, buckets, and reasons

Overview tab — example record

Key fields for quick scanning: room identity, creator, viewer count, and monitoring status.

{
  "sourceMode": "trending",
  "scrapedAt": "2026-03-24T12:07:27.166Z",
  "roomId": "7618658212682074898",
  "roomUrl": "https://www.tiktok.com/@aljazeera/live",
  "liveTitle": "تغطية مباشرة",
  "isActive": true,
  "creatorUsername": "aljazeera",
  "creatorDisplayName": "الجزيرة",
  "creatorFollowersCount": 16637007,
  "viewerCount": 10172,
  "priorityScore": 95,
  "audienceBucket": "large",
  "monitoringBucket": "watch-now",
  "monitoringReason": "Currently active with meaningful engagement"
}

Live Rooms tab — example record

Full room details with all engagement and activity signals.

{
  "sourceMode": "trending",
  "sourceInputType": "live_discovery",
  "sourceKeywords": [],
  "sourceCountries": [],
  "sourceCreators": [],
  "scrapedAt": "2026-03-24T12:07:27.165Z",
  "roomId": "7620631714633304863",
  "roomUrl": "https://www.tiktok.com/@elisefvc/live",
  "liveTitle": "bored playing roblox",
  "roomDescription": "ig - elisefvcc\n19\nr; dartstreak",
  "isActive": true,
  "startTime": "2026-03-24T01:44:16.000Z",
  "coverImageUrl": "https://p16-common-sign.tiktokcdn-eu.com/...",
  "categoryLabel": "Gaming",
  "creatorUsername": "elisefvc",
  "creatorProfileUrl": "https://www.tiktok.com/@elisefvc",
  "creatorId": "6730608152766825000",
  "creatorDisplayName": "elisefvc",
  "creatorVerified": false,
  "creatorFollowersCount": 42289,
  "creatorLikesCount": null,
  "creatorBio": "ig - elisefvcc\n19\nr; dartstreak",
  "viewerCount": 287,
  "likeCount": 67863,
  "commentCount": null,
  "shareCount": 76,
  "giftSignal": null,
  "cohostCount": null,
  "streamLanguage": null,
  "region": null,
  "priorityScore": 70,
  "priorityReason": "Active room, Moderate viewer count, High engagement, Growing creator, Trending discovery",
  "audienceBucket": "medium",
  "activityBucket": "high",
  "isTrendingCandidate": true,
  "monitoringBucket": "watch-now",
  "monitoringReason": "Currently active with meaningful engagement",
  "position": 1,
  "isPartial": false,
  "errorType": null,
  "errorMessage": null
}

Creators tab — example record

Creator-focused view with profile data and follower metrics.

{
  "roomId": "7618658212682074898",
  "liveTitle": "تغطية مباشرة",
  "creatorUsername": "aljazeera",
  "creatorProfileUrl": "https://www.tiktok.com/@aljazeera",
  "creatorId": "7145007218517034000",
  "creatorDisplayName": "الجزيرة",
  "creatorVerified": false,
  "creatorFollowersCount": 16637007,
  "creatorLikesCount": null,
  "creatorBio": "مرحباً بكم في الحساب الرسمي لقناة الجزيرة على تيك توك",
  "viewerCount": 10172,
  "isActive": true,
  "sourceMode": "trending"
}

Monitoring tab — example record

Qualification and prioritization view for shortlisting and watchlist workflows.

{
  "roomId": "7620679071743118110",
  "roomUrl": "https://www.tiktok.com/@giulianasanes/live",
  "liveTitle": "r u smarter than a 5th grader",
  "creatorUsername": "giulianasanes",
  "viewerCount": 149,
  "isActive": true,
  "priorityScore": 70,
  "priorityReason": "Active room, Moderate viewer count, High engagement, Growing creator, Trending discovery",
  "audienceBucket": "medium",
  "activityBucket": "high",
  "isTrendingCandidate": true,
  "monitoringBucket": "watch-now",
  "monitoringReason": "Currently active with meaningful engagement"
}

Output fields

Source lineage fields (6)

Field	Description
sourceMode	Discovery mode that found this room (trending, creator, keyword)
sourceInputType	Input type (live_discovery, creator_profile, keyword_search)
sourceKeywords	Keywords used in this discovery (array)
sourceCountries	Countries filtered for (array)
sourceCreators	Creator usernames targeted (array)
scrapedAt	ISO 8601 timestamp of extraction

Room identity fields (8)

Field	Description
roomId	TikTok LIVE room ID
roomUrl	Direct URL to the live room
liveTitle	Stream title set by the creator
roomDescription	Room description (usually the creator's bio)
isActive	Whether the room is currently active
startTime	Stream start time (ISO 8601)
coverImageUrl	Cover/thumbnail image URL
categoryLabel	Room category or tag (e.g., Gaming, News & Event)

Creator fields (8)

Field	Description
creatorUsername	TikTok username
creatorProfileUrl	Full profile URL
creatorId	TikTok user ID
creatorDisplayName	Display name / nickname
creatorVerified	Verified badge status
creatorFollowersCount	Follower count
creatorLikesCount	Total likes received (when available)
creatorBio	Profile bio

Audience / activity fields (8)

Field	Description
viewerCount	Current viewer count
likeCount	Like count on the live session
commentCount	Comment count (when available)
shareCount	Share count (when available)
giftSignal	Gift/monetization indicator (when publicly visible)
cohostCount	Number of co-hosts (when visible)
streamLanguage	Stream language (when derivable)
region	Region/country code

Discovery / qualification fields (7)

Field	Description
priorityScore	Composite priority score (0–100)
priorityReason	Human-readable explanation for the score
audienceBucket	small / medium / large based on viewer count
activityBucket	low / medium / high based on engagement signals
isTrendingCandidate	Whether the room qualifies as trending
monitoringBucket	watch-now / watchlist / low-priority
monitoringReason	Explanation for the monitoring classification

Run metadata fields (4)

Field	Description
position	Position/rank in discovery results
isPartial	Whether the record has incomplete data
errorType	Error type if extraction failed
errorMessage	Error message if extraction failed

Summary record

When includeSummary is enabled, a summary record is appended to the dataset with aggregated run statistics.

{
  "recordType": "summary",
  "totalRoomsReturned": 68,
  "totalRoomsAfterDedup": 68,
  "roomsBySourceMode": {
    "trending": 68
  },
  "roomsByCountry": {
    "unknown": 68
  },
  "activeRoomsByAudienceBucket": {
    "medium": 12,
    "small": 45,
    "large": 11
  },
  "roomsByMonitoringBucket": {
    "watch-now": 67,
    "low-priority": 1
  },
  "topCreators": [
    { "username": "elisefvc", "roomCount": 1 },
    { "username": "giulianasanes", "roomCount": 1 },
    { "username": "aljazeera", "roomCount": 1 },
    { "username": "tribunnews", "roomCount": 1 }
  ],
  "averageViewerCount": 618,
  "topLiveTitles": [
    "تغطية مباشرة",
    "Tribunnews Live 24 Jam",
    "Watch GB News live",
    "ウェザーニュースLiVE",
    "ASMR🩷"
  ],
  "runStatus": "completed",
  "startedAt": "2026-03-24T12:06:28.461Z",
  "finishedAt": "2026-03-24T12:07:49.199Z",
  "durationSeconds": 81
}

Priority scoring

Each room receives a composite priority score (0–100) based on:

Signal	Points
Active room	+20
Very high viewers (10,000+)	+30
Solid viewers (1,000+)	+25
Moderate viewers (100+)	+15
High engagement (10,000+ total)	+20
Large creator (1M+ followers)	+15
Mid-size creator (100K+)	+10
Trending discovery	+10
Keyword/creator discovery	+5

The priorityReason field explains which factors contributed to each room's score.

Monitoring buckets

Rooms are classified into actionable monitoring tiers:

Bucket	When assigned
watch-now	Active room with score 60+, medium/large audience, or high activity
watchlist	Score 40+ or 50+ viewers
low-priority	Low signals or insufficient data

Each room includes a monitoringReason explaining the classification in plain language.

Use cases

• LIVE trend discovery — Find what's trending in TikTok LIVE right now
• Creator monitoring — Track when specific creators go live and their audience metrics
• Audience/activity research — Collect public engagement signals from live rooms
• Niche monitoring — Watch LIVE activity related to specific topics or markets
• Event tracking — Capture LIVE session metadata for reporting and analysis
• AI/analytics workflows — Export structured LIVE data for dashboards, alerts, and LLM analysis
• Live-commerce research — Track live shopping sessions and audience response

Proxy configuration

Residential proxies are recommended for reliable TikTok scraping. TikTok applies rate limiting and bot detection that datacenter proxies may not handle well.

{
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"]
  }
}

Export

Results export to JSON, CSV, Excel, and other formats via the Apify dataset. The flat 41-field schema is ready for:

• Google Sheets / Airtable
• BI tools (Tableau, Looker, Power BI)
• AI/LLM pipelines
• Custom integrations via Apify API

Limitations

• All data comes from public TikTok LIVE surfaces. No private data, login-required features, or private analytics are accessed.
• Live rooms are time-sensitive. Rooms may end between discovery and extraction. Partial results are clearly marked with isPartial: true.
• Some fields are source-dependent. Not all room and audience fields are available for every room. Unavailable fields are set to null.
• Viewer counts may be approximate. TikTok may expose rounded or delayed viewer counts.
• Prioritization fields are heuristics. Priority scores and monitoring buckets are derived from public signals and reflect practical guidance, not exact rankings.
• Keyword mode depends on TikTok's search surface supporting live-room results, which may vary by region and availability.

Cost

Pricing is usage-based, charged per live-room record collected. Use maxRooms and mode selection to control costs.