Skip to main content
GET
TikTok Live
💳 1 credit per request

Authorizations

X-API-Key
string
header
required

API key for authentication. Format: sk_live_xxxxxxxxxxxxx

Get your API key from the Dashboard.

Query Parameters

handle
string
required

TikTok handle

Example:

"thejustalex"

Response

Successful response

Key Response Fields:

  • data.liveRoomUserInfo.uniqueId: Streamer's TikTok username
  • data.liveRoomUserInfo.nickname: Streamer's display name
  • data.liveRoomUserInfo.id: Streamer's user ID
  • data.liveRoomUserInfo.secUid: Streamer's secure user ID
  • data.liveRoomUserInfo.followerCount: Streamer's follower count
  • data.liveRoomUserInfo.followingCount: Streamer's following count
  • data.liveRoomUserInfo.avatarLarger: Streamer's profile picture (high-res)
  • data.liveRoomUserInfo.signature: Streamer's bio
  • data.liveRoomUserInfo.roomId: Live room ID
  • data.liveRoomUserInfo.status: User's live status (4 = currently live)
  • data.liveRoom.title: Live stream title
  • data.liveRoom.startTime: Unix timestamp of when the stream started
  • data.liveRoom.coverUrl: Live stream cover image URL
  • data.liveRoom.status: Stream status (4 = live)
  • data.liveRoom.liveRoomStats.userCount: Current viewer count
  • data.liveRoom.liveRoomStats.enterCount: Total unique viewers who entered
  • data.liveRoom.streamData.pull_data.stream_data: JSON string containing stream URLs — parse it to get FLV, HLS (m3u8), and CMAF URLs at various quality levels (origin, uhd_60, hd_60, hd, sd, ld)
  • data.liveRoom.streamData.pull_data.options.qualities[]: Available stream quality options with name (e.g. 1080p60, 720p) and sdk_key
  • data.liveRoom.streamId: Unique stream identifier
  • data.liveRoom.liveSubOnly: Whether the stream is subscriber-only
  • data.liveRoom.gameTagId: Game category tag (for gaming streams)