TikTok LIVE API
Connect to any TikTok LIVE stream over WebSocket. Receive every gift event - including Hall of Legend - in real time. 7-day evaluation key, no credit card.
Read the docs →| Gifts sent | Coins | Buyer cost (approx.) | Diamonds to creator | Creator payout (approx.) |
|---|---|---|---|---|
| 1 x Hall of Legend | 11,999 | $119.99 | 11,999 | $60.00 |
| 10 x Hall of Legend | 119,990 | $1,199.90 | 119,990 | $599.95 |
| 100 x Hall of Legend | 1,199,900 | $11,999.00 | 1,199,900 | $5,999.50 |
Buyer cost uses a reference rate of 100 coins per $1. TikTok sells coins in packs, and the price per coin depends on the pack size, the store and your region; web checkout and in-app purchases (which include app store fees) usually cost more than this rate. Creator payout uses $0.005 per diamond, before any agency share. Convert any amount with the diamonds calculator.
One request returns the full TikTok LIVE gift catalog - every name, diamond cost, and icon URL. Drop it straight into your own app.
// npm install @tiktool/live
import { TikTokLive } from '@tiktool/live';
const live = new TikTokLive({ apiKey: 'YOUR_TIKTOOLS_KEY' });
// Fetch the full gift gallery / catalog (Pro+ = full live catalog).
const res = await fetch('https://api.tik.tools/webcast/gift_info', {
headers: { 'x-api-key': 'YOUR_TIKTOOLS_KEY' },
});
const { data } = await res.json();
// data.gifts[] = every gift: name, diamond_count, icon URL, id.
for (const g of data.gifts) {
console.log(g.name, g.diamond_count, g.icon);
}Connect to any TikTok LIVE stream over WebSocket. Receive every gift event - including Hall of Legend - in real time. 7-day evaluation key, no credit card.
Read the docs →Browse the global gifter leaderboard - real users sending Hall of Legend and every other gift across 44 regions, updated continuously.
Gifters leaderboard →One npm install -> live events in your terminal. Node.js + Python officially supported.
Quick start →Hall of Legend costs 11,999 coins. At the reference rate of 100 coins per $1 that is about $119.99. The real checkout price depends on the coin pack, store and region, and in-app purchases usually cost more because of app store fees.
The creator is credited 11,999 diamonds. At the payout rate of $0.005 per diamond that is about $60.00, before any agency share.
10 Hall of Legend gifts cost 119,990 coins (about $1,199.90) and credit the creator 119,990 diamonds (about $599.95).
Gifts at a similar price include Dubai Fireworks (11,999 coins), 3rd Anniversary (12,000 coins) and BlackBear (12,000 coins).
Drop the free SDK in your app and stream gift, chat, like, follow, and battle events from any TikTok LIVE room.