TikTok LIVE
WebSocket API.
Serverless.
No scraping. No clunky libraries. Raw WebSockets.
Every Event, Real-Time
Receive structured JSON events for every interaction happening in the stream. From gifts to comments, likes to follows — all delivered in milliseconds.
Gifts
Track gift sends with coin values, combos, streak counts, and sender information.
{
"type": "gift",
"user": { "uniqueId": "viewer123", "nickname": "StreamFan" },
"gift": { "name": "Rose", "diamondCount": 1, "repeatCount": 5 },
"totalValue": 5
}Comments
Receive chat messages with user info, badges, and emotes in real-time.
{
"type": "chat",
"user": { "uniqueId": "chatter99", "nickname": "ChatMaster" },
"comment": "This stream is amazing! 🔥",
"badges": ["moderator", "subscriber"]
}Likes
Count likes and double-taps with aggregated totals per user session.
{
"type": "like",
"user": { "uniqueId": "fan2024", "nickname": "LikeMachine" },
"likeCount": 15,
"totalLikes": 48523
}Follows
Get instant notifications when viewers follow the streamer.
{
"type": "follow",
"user": { "uniqueId": "newfan", "nickname": "NewFollower" },
"followerCount": 125000
}Shares
Know when viewers share the stream to their friends and followers.
{
"type": "share",
"user": { "uniqueId": "sharer1", "nickname": "Promoter" },
"shareCount": 3
}Joins
Welcome new viewers with join events and viewer count updates.
{
"type": "member",
"user": { "uniqueId": "newviewer", "nickname": "JustJoined" },
"viewerCount": 1523
}And many more event types including room info, stream status, battles, and custom events.
Explore all event types in our TypeScript SDKStart building
in minutes.
Connect to any TikTok LIVE stream with a single WebSocket connection. No API keys required for the free tier.