TikTok Live Comments — Unlimited Events Scraper

Capture every real-time event from any TikTok live stream with zero message limits. Comments, gifts, likes, joins, follows, shares, subscriptions, Q&A, polls, pinned messages, LinkMic battles, and live viewer stats — all streamed instantly into your Dataset as they happen.

What it does

• Connects directly to an active TikTok live stream via WebSocket.
• Captures every event in real time: comments, gifts, likes, joins, follows, shares, subscriptions, Q&A questions, polls, pinned messages, and LinkMic battles.
• Polls the LinkMic API every 15 seconds to detect and track active hosts and co-hosts.
• Enriches each event with full user metadata: user ID, unique ID, sec UID, nickname, avatar URL, follower/following counts, subscriber badge, moderator flag, gifter level, and pay grade.
• Runs until the stream ends or your configured duration limit is reached — no caps, no pagination, no sampling.

Input

Field	Type	Required	Description
username	string	Yes	TikTok creator username without @
cookies	array	No	TikTok session cookies exported as JSON (strongly recommended)
max_duration_seconds	integer	No	Maximum capture duration in seconds. 0 = unlimited (default: 0)
poll_interval_seconds	integer	No	LinkMic host polling interval in seconds (default: 15)

Example input

{
  "username": "cristiano",
  "max_duration_seconds": 0,
  "poll_interval_seconds": 15
}

Output

Each record in the Dataset represents one event from the live stream.

Common fields

Field	Description
event_type	Type of event: comment, gift, like, join, follow, share, subscribe, question, poll, pin, battle, viewer_count, host
timestamp	ISO 8601 timestamp of the event
username	Streamer username
user_id	Event sender user ID
unique_id	Event sender unique ID (handle)
nickname	Event sender display name
text	Comment or question text (when applicable)
gift_name	Gift name (for gift events)
diamond_count	Gift diamond value (for gift events)
viewer_count	Current viewer count (for viewer_count events)

How to use cookies

1. Log in to TikTok in Chrome or Firefox.
2. Install the Cookie-Editor browser extension.
3. On tiktok.com, open Cookie-Editor and click Export → JSON.
4. Paste the JSON array into the cookies input field.

Cookies are strongly recommended to avoid rate limits, access HD streams, and unlock full user metadata.

Notes

• Set max_duration_seconds to 0 for truly unlimited capture — the Actor stops when the stream ends naturally.
• If the creator is not yet live, the Actor waits and retries automatically.
• All events are pushed to the Apify Dataset in real time.

Categories

Automation · Developer tools · Social media