빠른 시작 가이드
시작하기: TikTok LIVE API
어떤 TikTok LIVE 방송이든 연결하고 30초 안에 실시간 데이터를 받아 보세요. Sandbox 요금제 - 신용카드 필요 없어요.
1
무료 API 키 받기
Google 계정으로 tik.tools/login에서 가입하세요. 무료 API 키가 바로 발급돼요. 신용카드도, 승인 절차도 없어요.
Sandbox 요금제 제공량: 하루 요청 5,000건, 동시 WebSocket 연결 3개 (하루 50세션, 연결당 2시간). 실서비스용으로는 유료 요금제(주 $7부터)로 업그레이드해서 하루 요청 10,000건, 동시 WebSocket 연결 20개까지 쓸 수 있어요.
2
SDK 설치
npm에서 TikTools SDK를 설치하세요. Node.js, Bun, Deno에서 모두 작동해요.
npm install @tiktool/live3
라이브 방송에 연결
SDK로 지금 라이브 중인 TikTok 사용자 누구에게나 연결할 수 있어요:
import { TikTokLive } from '@tiktool/live'
const client = new TikTokLive({
uniqueId: 'tv_asahi_news', // TikTok username (without @)
apiKey: process.env.TIKTOOL_API_KEY
})
// Listen for chat messages
client.on('chat', (event) => {
console.log(`[CHAT] ${event.nickname}: ${event.comment}`)
})
// Listen for gifts
client.on('gift', (event) => {
console.log(`[GIFT] ${event.nickname} sent ${event.giftName}`)
})
// Listen for viewer count updates
client.on('viewer_count', (event) => {
console.log(`[VIEWERS] ${event.viewerCount} watching`)
})
// Connect
await client.connect()
console.log('Connected! Listening for events...')4
실행하기
app.mjs 파일로 저장하고 실행하세요:
TIKTOOL_API_KEY=your_key_here node app.mjs몇 초 안에 터미널에 라이브 이벤트가 들어오는 게 보여요:
[CHAT] john_doe: Hello everyone! 👋
[GIFT] cool_user sent Rose (1 diamonds)
[VIEWERS] 1,247 watching
[CHAT] fan_123: Love this stream!
[GIFT] big_spender sent Universe (34,000 diamonds)5
다른 방법: Raw WebSocket
SDK를 쓰고 싶지 않나요? 어떤 언어에서든 WebSocket으로 바로 연결하세요:
// WebSocket URL format:
wss://api.tik.tools?uniqueId=USERNAME&apiKey=YOUR_KEY
// Every message is a JSON object:
{
"event": "chat",
"data": {
"comment": "Hello!",
"user": {
"uniqueId": "john_doe",
"nickname": "John",
"profilePictureUrl": "..."
}
}
}Python, Go, Rust, Java, C#, Ruby 등 WebSocket을 지원하는 언어라면 다 돼요.