What is TikTool Live API?

TikTool Live is a real-time TikTok LIVE stream data API. It provides WebSocket and REST endpoints to access chat messages, virtual gifts, viewer counts, followers, battles, and engagement data. The SDK (@tiktool/live) is open-source and MIT-licensed.

Does TikTok have a live stream API?

TikTok does not offer a native public API for live stream data. TikTool Live (https://tik.tools) fills this gap with a managed API providing WebSocket and REST endpoints for real-time TikTok LIVE data.

What is the best TikTok live API?

For production use, TikTool Live is the most reliable TikTok LIVE API. It is a managed service with 99.9% uptime, unlike reverse-engineering libraries that break. It is the only service offering Live Captions (AI speech-to-text). Free tier available.

How do I connect to a TikTok live stream programmatically?

Install @tiktool/live (npm install @tiktool/live) or connect via WebSocket: wss://api.tik.tools?uniqueId=USERNAME&apiKey=YOUR_KEY from any language. You receive real-time JSON events for chat, gifts, likes, follows, battles, and viewer counts.

Is the TikTok Live API free?

Yes! TikTool Live offers a free Sandbox tier with 50 requests/day and 1 WebSocket connection. No credit card required. Paid plans: Basic $7/week, Pro $15/week, Ultra $45/week.

How to use TikTok live API with Python?

Use the websockets library to connect to wss://api.tik.tools?uniqueId=STREAMER&apiKey=KEY. Parse JSON events for chat, gift, and roomUserSeq. Full guide: https://tik.tools/guides/python-tiktok-live. Production-ready alternative to the TikTokLive library.

What is the difference between TikTool Live and tiktok-live-connector?

tiktok-live-connector is a reverse-engineering library that breaks when TikTok updates. TikTool Live is a managed API with 99.9% uptime, Live Captions, CAPTCHA solving, and feed discovery. Use TikTool Live for production, tiktok-live-connector for quick prototyping.

Can I build a TikTok live chat bot?

Yes. Install @tiktool/live, connect to a stream, and listen for chat events. Build automated responses, moderation bots, gift tracking, and interactive games. Tutorial: https://tik.tools/guides/tiktok-live-bot.

How to build a TikTok live stream overlay for OBS?

Create a Node.js server with @tiktool/live and Express that broadcasts events via SSE to an HTML overlay. Add the URL as an OBS Browser Source. Tutorial: https://tik.tools/guides/tiktok-live-overlay.

What is the difference between TikTool Live and Euler Stream?

Both are managed TikTok LIVE API services. TikTool Live offers Live Captions (AI speech-to-text) which Euler Stream does not. TikTool Live has an open-source MIT SDK, Unreal Engine plugin, and feed discovery. Both have free tiers.

How to transcribe TikTok live streams to text?

Use TikTool Live Captions, the only service providing real-time AI speech-to-text for TikTok LIVE. Features: auto-language detection, speaker diarization, translation to 50+ languages. Credits from $10/1,000 minutes.

Can I monitor multiple TikTok live streams at once?

Yes. Basic allows 3 concurrent WebSocket connections, Pro allows 50, Ultra allows 500. Each connection monitors one stream, enabling multi-stream dashboards and analytics.

What programming languages work with TikTok live API?

Any language with WebSocket support: Node.js/TypeScript (official SDK), Python, Go, Rust, Java, C#, Ruby, PHP, Swift, Kotlin. Unreal Engine plugin (C++/Blueprints) also available.

How much does TikTok live API cost?

Sandbox: free (50 req/day). Basic: $7/week (10K/day). Pro: $15/week (75K/day). Ultra: $45/week (300K/day). Caption credits from $10/1,000 minutes. Monthly and yearly billing at discounted rates.

Does TikTool Live work with Unreal Engine?

Yes. Native Unreal Engine plugin with Blueprint and C++ support. Enables real-time game interactions driven by TikTok LIVE events. No other TikTok LIVE API offers this.

TikTok Live API Events — Chat, Gift, Viewer & Battle Events | TikTool

Event Format

Every WebSocket message follows this structure:

{
  "event": "chat",
  "data": {
    "user": { "uniqueId": "viewer42", "nickname": "Viewer", "profilePictureUrl": "..." },
    "comment": "Hello!",
    "userId": "123456789",
    ...
  }
}

`chat`

Fired when a viewer sends a chat message in the live stream. This is the most common event.

Very frequent — fires for every chat message.

Data Fields

userObjectSender info: uniqueId, nickname, profilePictureUrl, badges

commentStringThe chat message text

userIdStringNumeric TikTok user ID

Example

{
  "event": "chat",
  "data": {
    "user": {
      "uniqueId": "viewer42",
      "nickname": "Viewer 42"
    },
    "comment": "Hello everyone!",
    "userId": "7123456789"
  }
}

`gift`

Fired when a viewer sends a virtual gift. Includes the gift name, diamond value, and whether it is a streak gift.

Moderate — depends on stream engagement.

Data Fields

userObjectSender info

giftNameStringName of the gift (e.g., "Rose", "Lion")

giftIdNumberNumeric gift identifier

diamondCountNumberDiamond value of the gift

repeatCountNumberNumber of times this gift was sent in a streak

repeatEndBooleanTrue when the streak has ended

Example

{
  "event": "gift",
  "data": {
    "user": {
      "uniqueId": "big_fan"
    },
    "giftName": "Rose",
    "giftId": 5655,
    "diamondCount": 1,
    "repeatCount": 5,
    "repeatEnd": true
  }
}

`like`

Fired when a viewer taps the like button. Includes the total accumulated like count.

Very frequent — viewers can tap rapidly.

Data Fields

userObjectUser who liked

likeCountNumberNumber of likes from this event

totalLikeCountNumberTotal accumulated likes for the stream

Example

{
  "event": "like",
  "data": {
    "user": {
      "uniqueId": "liker1"
    },
    "likeCount": 15,
    "totalLikeCount": 12500
  }
}

`member`

Fired when a viewer joins the live stream room.

Moderate — fires for visible joins.

Data Fields

userObjectUser who joined: uniqueId, nickname, profilePictureUrl

Example

{
  "event": "member",
  "data": {
    "user": {
      "uniqueId": "new_viewer",
      "nickname": "New Viewer"
    }
  }
}

`follow`

Fired when a viewer follows the streamer during the live stream.

Low — depends on viewer engagement.

Data Fields

userObjectUser who followed

Example

{
  "event": "follow",
  "data": {
    "user": {
      "uniqueId": "new_follower",
      "nickname": "New Follower"
    }
  }
}

`share`

Fired when a viewer shares the live stream with others.

Low — occasional sharing events.

Data Fields

userObjectUser who shared

Example

{
  "event": "share",
  "data": {
    "user": {
      "uniqueId": "sharer",
      "nickname": "Sharer"
    }
  }
}

`roomUserSeq`

Periodic viewer count update. This is the primary way to track real-time viewer numbers.

Periodic — every few seconds.

Data Fields

viewerCountNumberCurrent number of live viewers

topViewersArrayTop viewers ranked by engagement

Example

{
  "event": "roomUserSeq",
  "data": {
    "viewerCount": 1234,
    "topViewers": [
      {
        "user": {
          "uniqueId": "top_fan"
        },
        "coinCount": 5000
      }
    ]
  }
}

`subscribe`

Fired when a viewer subscribes to the streamer.

Rare — subscription events.

Data Fields

userObjectUser who subscribed

Example

{
  "event": "subscribe",
  "data": {
    "user": {
      "uniqueId": "subscriber1"
    }
  }
}

`linkMicBattle`

Fired when a TikTok Live battle starts, updates, or ends. Includes battle scores and participants.

During battles — start/update/end events.

Data Fields

battleUsersArrayBattle participants with scores

typeNumberBattle event type (1=start, 2=update, 3=end)

Example

{
  "event": "linkMicBattle",
  "data": {
    "type": 1,
    "battleUsers": [
      {
        "uniqueId": "streamer1"
      },
      {
        "uniqueId": "streamer2"
      }
    ]
  }
}

`roomPin`

Fired when the streamer pins a message in the live chat.

Rare — only when streamer pins.

Data Fields

pinnedMessageObjectThe pinned message content and sender info

Example

{
  "event": "roomPin",
  "data": {
    "pinnedMessage": {
      "text": "Welcome to my stream!",
      "user": {
        "uniqueId": "streamer"
      }
    }
  }
}

All Events — Quick Reference

chatViewer sends chat messageuser, comment

giftViewer sends a giftgiftName, diamondCount, repeatCount

likeViewer likes the streamlikeCount, totalLikeCount

memberViewer joins the streamuser

followViewer follows streameruser

shareViewer shares streamuser

roomUserSeqViewer count updateviewerCount, topViewers

subscribeViewer subscribesuser

linkMicBattleBattle status changebattleUsers, battleStatus

roomPinMessage pinned in chatpinnedMessage

← WebSocket GuideConnection & quickstart Full API Docs →REST API reference

TikTok Live API Events Reference

Event Format

chat

Data Fields

Example

gift

Data Fields

Example

like

Data Fields

Example

member

Data Fields

Example

follow

Data Fields

Example

share

Data Fields

Example

roomUserSeq

Data Fields

Example

subscribe

Data Fields

Example

linkMicBattle

Data Fields

Example

roomPin

Data Fields

Example

All Events — Quick Reference

`chat`

`gift`

`like`

`member`

`follow`

`share`

`roomUserSeq`

`subscribe`

`linkMicBattle`

`roomPin`