WebSocket API

TikTok LIVE
WebSocket API

채팅, 선물, 좋아요, 팔로우, 시청자 수, 배틀 등 TikTok LIVE 실시간 이벤트를 관리형 WebSocket 연결 하나로 스트리밍하세요. 50ms 미만 지연. 99.9% 가동률.

무료 API 키 받기 문서 보기

wss://api.tik.tools?uniqueId=USERNAME&apiKey=YOUR_KEY

<50ms지연 시간

99.9%가동률

90+이벤트 유형

모든언어

코드 3줄로 연결하기

바이너리 파싱도, 인프라 부담도 없어요. 깔끔한 JSON을 보내주는 WebSocket URL 하나면 돼요.

import WebSocket from 'ws';

const ws = new WebSocket('wss://api.tik.tools?uniqueId=streamer&apiKey=YOUR_KEY');

ws.on('message', (raw) => {
  const msg = JSON.parse(raw);
  console.log(msg.event, msg.data);
});

모든 이벤트 살펴보기

이벤트를 고르면 WebSocket이 보내는 정확한 JSON과 각 필드 설명을 볼 수 있어요.

가상 선물

event: "gift"

{
  "event": "gift",
  "data": {
    "user": {
      "uniqueId": "streamfan_22",
      "nickname": "Stream Fan",
      "userId": "6776543210987654321",
      "followRole": 2,
      "isSubscriber": true
    },
    "giftId": 5655,
    "giftName": "Rose",
    "diamondCount": 1,
    "repeatCount": 12,
    "repeatEnd": true,
    "groupId": "1718900000123",
    "giftType": 1,
    "receiverUserId": "6776000000000000010",
    "timestamp": 1718900000123
  }
}

giftNamestring보낸 선물의 표시 이름.

diamondCountnumber선물 한 개 단위의 다이아몬드 가치.

repeatCountnumber콤보로 보낸 개수.

repeatEndboolean연속 선물이 끝나면 true - 이 프레임에서 합산하세요.

userobject보낸 사람 프로필: uniqueId, 닉네임, 팔로우 + 구독 상태.

receiverUserIdstring선물을 받은 크리에이터. 라이브 멀티 게스트에서는 방 소유자가 아니라 특정 게스트/호스트일 수 있어요.