LogoEuler Stream

Meet the AI-friendly #1

Cloud-Native
TikTok LIVE
WebSocket API

Offering TikTok LIVE events in any language.

Get StartedDocumentation
1M+
events/day
<50ms
latency
99.9%
uptime
Wifi

See it in live-action

Connect to a real TikTok LIVE stream and watch events flow in real-time.

const apiKey = "MY_API_KEY";
const wsUrl = `wss://ws.eulerstream.com?uniqueId=tv_asahi_news&apiKey=${apiKey}`;
const ws = new WebSocket(wsUrl);
 
// Log event messages
ws.onmessage = (event) => {
  const data = JSON.parse(event.data);
  if (data && data.messages) {
    data.messages.forEach((msg) => {
      console.log(msg);
    });
  }
}
> Connect to @tv_asahi_news on TikTok LIVE
Flash

Check out the events we support...

Euler Stream supports over 250+ extra events available exclusively through the WebSocket API.

Chat & comments

14 events

Open source

  • Barrage
  • Caption
  • Chat
  • EmoteChat
  • ImDelete
  • MsgDetect

Euler Stream

  • Barrage
  • Caption
  • Chat
  • CommentReply
  • Comments
  • CommentTray
  • EmoteChat
  • ImDelete
  • MsgDetect
  • QuickChatList
  • ScreenChat
  • StarCommentNotification
  • StarCommentPush
  • Whisper

Viewers & engagement

16 events

Open source

  • Like
  • Member
  • Social
  • UnauthorizedMember
  • ViewerPicksUpdate

Euler Stream

  • AudienceReserveUserState
  • BoostedUsers
  • Digg
  • FollowCard
  • Greeting
  • HotRoom
  • Like
  • Member
  • PopularCard
  • ShareGuide
  • Social
  • UnauthorizedMember
  • UserStats
  • ViewerPicksGiftPickReview
  • ViewerPicksUpdate
  • ViewerWishesGameTricks

Gifts

26 events

Open source

  • BoostCard
  • Capsule
  • Envelope
  • Gift
  • GiftBroadcast
  • GiftDynamicRestriction
  • GiftPanelUpdate
  • GiftPrompt
  • VaultGloveCardInfo

Euler Stream

  • Backpack
  • BoostCard
  • Capsule
  • CollabGift
  • Donation
  • DonationInfo
  • DonationStickerModifyMethod
  • Envelope
  • EnvelopePortal
  • Gift
  • GiftBroadcast
  • GiftCollectionUpdate
  • GiftDynamicRestriction
  • GiftGallery
  • GiftGuide
  • GiftNotice
  • GiftPanelUpdate
  • GiftProgress
  • GiftPrompt
  • GiftRecommendation
  • GiftRecordCapsule
  • GiftUnlock
  • GiftUpdate
  • GoodyBag
  • VaultGloveCardInfo
  • WishlistUpdate

Co-host & LinkMic

36 events

Open source

  • Link
  • LinkLayer
  • LinkMicArmies
  • LinkMicBattle
  • LinkMicBattleItemCard
  • LinkMicBattlePunishFinish
  • LinkmicBattleTask
  • LinkMicFanTicketMethod
  • LinkMicLayoutState
  • LinkMicMethod
  • LinkState

Euler Stream

  • AgreeApplyGuide
  • BattleAICommentary
  • BattleGameplay
  • CohostLayoutUpdate
  • CohostPlatform
  • CohostReserve
  • CohostSettingsUpdate
  • CohostSubtitleBan
  • CohostSubtitleSetting
  • CohostTopic
  • CohostTranslatePopUp
  • Link
  • LinkBusiness
  • LinkLayer
  • LinkLayout
  • LinkMicAd
  • LinkMicAnchorGuide
  • LinkmicAnimation
  • LinkMicArmies
  • LinkmicAudienceNotice
  • LinkMicBattle
  • LinkMicBattleArtifact
  • LinkMicBattleItemCard
  • LinkmicBattleNotice
  • LinkMicBattlePunishFinish
  • LinkmicBattleTask
  • LinkMicBattleVictoryLap
  • LinkMicFanTicketMethod
  • LinkMicLayoutState
  • LinkMicMethod
  • LinkMicOpponentGifts
  • LinkMicSignalingMethod
  • LinkScreenChange
  • LinkState
  • PermitOutsideApply
  • RivalsUpdate

Multi-guest

16 events

Open source

None

Euler Stream

  • GroupLiveMemberNotify
  • GuestInvite
  • GuestInviteGuide
  • GuestShowdown
  • MgActivityInRoomBanner
  • MGOutsideInvite
  • MGPunishCenterAction
  • MGQuickCallAutoApprove
  • MultiGuestBubble
  • MultiGuestGuide
  • MultiGuestHangoutLanding
  • MultiGuestPreApprove
  • MultiGuestRandomMatch
  • MultiGuestSuggest
  • MultiGuestTopGuest
  • MultiGuestUpdateSkylight

Games

32 events

Open source

  • GameRankNotify

Euler Stream

  • Competition
  • CompetitionContributor
  • CompetitionPlatform
  • CompetitionRankList
  • EsportsMatchUpdate
  • EsportsScoreBoardUpdate
  • GameAiScript
  • GameAutoPostNotice
  • GameEmoteUpdate
  • GameGuessPinCard
  • GameGuessToast
  • GameGuessWidgets
  • GameInteraction
  • GameInteractionMultiSource
  • GameLiveGoalRewardAudit
  • GameLiveGoalRewardNotify
  • GameMoment
  • GameOCRPing
  • GameRankNotify
  • GameRecommendCreateGuess
  • GameReqSetGuess
  • GameRevenueTips
  • GameServerFeature
  • GameSettingChange
  • MinuteGameUpdate
  • PictionaryEnd
  • PictionaryExit
  • PictionaryStart
  • PictionaryUpdate
  • PlaySnapshotSync
  • PlayTogether
  • PreviewGameMoment

Q&A, polls & quizzes

9 events

Open source

  • Poll
  • QuestionNew

Euler Stream

  • ActivityQuizCard
  • ActivityQuizUserIdentity
  • GuessQuestionAudit
  • Poll
  • QuestionDelete
  • QuestionNew
  • QuestionSelected
  • QuestionSlideDown
  • QuestionSwitch

Rankings

10 events

Open source

  • HourlyRankReward
  • RankText
  • RankUpdate
  • Top2CardInfo
  • Top3CardInfo

Euler Stream

  • DailyChallengesLiveCard
  • HourlyRankReward
  • RankNotice
  • RankText
  • RankToast
  • RankUpdate
  • ScorePerception
  • Top2CardInfo
  • Top3CardInfo
  • WeeklyRankReward

Subscriptions & fans

11 events

Open source

  • SubNotify
  • SubPinEvent

Euler Stream

  • FansCommunity
  • FansEvent
  • PrivilegeAdvance
  • PrivilegeDynamicEffect
  • SubContractStatus
  • SubNotify
  • SubPinEvent
  • SubQueue
  • SubscriptionGuide
  • SubTimerSticker
  • SubWave

Shop & commerce

29 events

Open source

  • OecLiveShopping

Euler Stream

  • BALeadGen
  • CommercialCustom
  • EcBarrage
  • EcDraw
  • EcDrawGrabRemind
  • EcShortItemRefresh
  • EcTaskRefreshCouponList
  • EcTaskRegister
  • OECAuctionAction
  • OECAuctionPaymentFailure
  • OECDisplayScriptInfo
  • OecLiveBillboard
  • OecLiveCreator
  • OecLiveForwarded
  • OecLiveHotRoom
  • OecLiveManager
  • OecLiveRank
  • OecLiveShopping
  • OecLiveSmartPin
  • OecLiveSuggest
  • OECPcScriptUpdate
  • OECPinCardStatusUpdate
  • PaidContentLiveShopping
  • PromoteAdStatus
  • SMBBoard
  • SMBStateSync
  • VideoLiveCouponRcmd
  • VideoLiveGoodsOrder
  • VideoLiveGoodsRcmd

Creator tools

25 events

Open source

  • GoalUpdate
  • Guide

Euler Stream

  • AnchorAiCoach
  • AnchorGetSubQuota
  • AnchorGrowLevel
  • AnchorGuideTrigger
  • AnchorReminderWord
  • AnchorTaskReminder
  • AnchorToolModification
  • ColdStart
  • FeatureGuide
  • GapHighlightPushGuide
  • GoalUpdate
  • Guide
  • GuideTask
  • HighlightFragementReady
  • HostBoard
  • HostFeature
  • InteractionHubGoal
  • NewAnchorGuide
  • NewPin
  • RealtimeLiveCenterMethod
  • RealtimeLiveCenterUpdate
  • RealTimePerformancePage
  • RealtimeUnifiedEntrance
  • UpdateShareRevenueNotice
  • WalletLiveRewardsRatio

Partnerships

9 events

Open source

  • PartnershipDropsUpdate
  • PartnershipGameOffline
  • PartnershipPunish

Euler Stream

  • PartnershipAnchor
  • PartnershipCardChange
  • PartnershipDownloadCount
  • PartnershipDropsAnchor
  • PartnershipDropsCardChange
  • PartnershipDropsUpdate
  • PartnershipGameOffline
  • PartnershipPunish
  • PartnershipTaskShow

Karaoke & music

7 events

Open source

  • MusicCardInfo

Euler Stream

  • KaraokeQueue
  • KaraokeQueueList
  • KaraokeRedDot
  • KaraokeReq
  • KaraokeSwitch
  • KaraokeYouSingReq
  • MusicCardInfo

Effects & AI

14 events

Open source

None

Euler Stream

  • AIBeautyResult
  • AIGCBackgroundReview
  • AILiveSummary
  • AISummary
  • AvatarGenerateResult
  • AvatarReportDelete
  • AvatarStyleResult
  • BizSticker
  • EffectControl
  • EffectPreloading
  • InteractiveEffect
  • StageReaction
  • Wallpaper
  • WallpaperReview

Room & system

57 events

Open source

  • AccessControl
  • AccessRecall
  • Bottom
  • Control
  • InRoomBanner
  • LiveGameIntro
  • LiveIntro
  • MarqueeAnnouncement
  • Notice
  • Perception
  • Room
  • RoomNotify
  • RoomPin
  • RoomUserSeq
  • RoomVerify
  • Speaker
  • System
  • Toast

Euler Stream

  • AccessControl
  • AccessRecall
  • Asset
  • AuthorizationNotify
  • Bottom
  • CommonPopup
  • CommonToast
  • Control
  • Countdown
  • CountdownForAll
  • Epi
  • Event
  • ExecutorDispatch
  • FeedUserRoomMonitor
  • ForceFetchRecommendations
  • Hashtag
  • InRoomBanner
  • InRoomBannerEvent
  • InRoomBannerRefresh
  • LiveCenterStatusBar
  • LiveChain
  • LiveGameIntro
  • LiveInfoAuditNotice
  • LiveIntro
  • LiveJourney
  • LiveShow
  • MarqueeAnnouncement
  • MiddleTouch
  • Notice
  • Noticeboard
  • NoticeboardReview
  • OChannelAnchor
  • OChannelModify
  • OChannelUser
  • Perception
  • Playbook
  • Portal
  • ProjectDModifyH5
  • Room
  • RoomBottom
  • RoomEvent
  • RoomNotify
  • RoomPin
  • RoomSticker
  • RoomStreamAdaptation
  • RoomUserSeq
  • RoomVerify
  • ShortTouch
  • Speaker
  • SpecialPush
  • StreamStatus
  • System
  • TextHeader
  • Toast
  • Tray
  • TTLSLiveControl
  • Upgrade

Frequently Asked Questions

A managed WebSocket server at wss://ws.eulerstream.com. Open a connection with a creator's username and it streams their LIVE events, such as gifts, comments, likes, follows and joins, to you as JSON in real time. There is no library to install and no TikTok signing or scaling to run yourself.

From your backend, open wss://ws.eulerstream.com?uniqueId=CREATOR&apiKey=YOUR_KEY with any WebSocket client. In Node.js that is two lines of code. Read the WebSocket docs

Yes. Your backend creates a short-lived JSON Web Token limited to the creators a user may watch and the number of WebSockets they may open, and the browser connects with jwtKey in place of apiKey. Your API key never reaches the client. See the JWT guide

Any language with a WebSocket client. The WebSocket SDK adds TypeScript types for Node.js and the browser, and the event schemas are published for every other language.

Every top-level event TikTok LIVE sends: 311 event types, against the 66 that open-source libraries decode. The first message on every connection is a roomInfo event with the stream's details, such as the creator's profile and the room ID.

The free Community plan includes 25 concurrent WebSockets. Business plans raise that to between 100 and 1,000 depending on the tier, Business 200K can add up to 5,000 more with the Additional LIVE WebSockets add-on, and Enterprise plans start at 1,000. See pricing

While the creator is live, for up to 8 hours per connection. The server closes the socket with a specific close code when the stream ends, when the creator is not live, or when the 8 hour limit is reached, so your client knows when to reconnect.

TikTok's livestreaming feature, where creators broadcast to viewers who chat, like and send gifts in real time. Every one of those interactions is an event this WebSocket delivers. Learn how TikTok LIVE works