TikTok LIVEAPI⁠

// live-events.mjs
// Run: node live-events.mjs                  (random live creator)
//      node live-events.mjs aljazeeraenglish (specific channel)
// Requires Node 22+ (native WebSocket). Zero npm install.

const KEY  = 'your_api_key';   // <- swap for your free key at https://tik.tools
const USER = (process.argv[2] || '').replace(/^@/, '');
const API  = 'https://api.tik.tools', WS = 'wss://api.tik.tools';

let user = USER;
if (!user) {
  const r = await fetch(API + '/api/live/top-channels').then(r => r.json());
  user = r.channels?.[0]?.uniqueId;
  if (!user) { console.log('No live creators right now.'); process.exit(0); }
  console.log('Random live pick:', user);
}

const j = await fetch(API + '/authentication/jwt?apiKey=' + KEY, {
  method: 'POST', headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ allowed_creators: [user], expire_after: 600, max_websockets: 1 }),
}).then(r => r.json());
const token = j.data?.token;
if (!token) { console.log('Auth failed:', j); process.exit(1); }

console.log('Connecting to @' + user);
const ws = new WebSocket(`${WS}?uniqueId=${user}&jwtKey=${encodeURIComponent(token)}`);
ws.onmessage = ev => {
  const e = JSON.parse(ev.data);
  if (e.event === 'roomInfo') return;
  const d = e.data || {};
  console.log(`[${e.event}]`, d.user?.nickname || d.user_unique_id || '', d.comment || d.giftName || '');
};
ws.onclose = ev => { console.log('Closed:', ev.reason || ev.code); };

# live_events.py
# Run: pip install websockets
#      python live_events.py                  (random live creator)
#      python live_events.py aljazeeraenglish (specific channel)
import asyncio, json, sys, urllib.request, websockets

KEY  = 'your_api_key'  # <- swap for your free key at https://tik.tools
USER = (sys.argv[1] if len(sys.argv) > 1 else '').lstrip('@')
API  = 'https://api.tik.tools'; WS = 'wss://api.tik.tools'

def call(url, body=None):
    req = urllib.request.Request(url, method='POST' if body else 'GET',
        headers={'Content-Type': 'application/json'},
        data=json.dumps(body).encode() if body else None)
    return json.loads(urllib.request.urlopen(req).read())

async def main():
    user = USER
    if not user:
        r = call(API + '/api/live/top-channels')
        user = (r.get('channels') or [{}])[0].get('uniqueId', '')
        if not user: print('No live creators right now.'); return
        print('Random live pick:', user)
    j = call(API + '/authentication/jwt?apiKey=' + KEY,
             {'allowed_creators': [user], 'expire_after': 600, 'max_websockets': 1})
    token = j.get('data', {}).get('token')
    if not token: print('Auth failed:', j); return
    print('Connecting to @' + user)
    url = f"{WS}?uniqueId={user}&jwtKey={token}"
    async with websockets.connect(url) as ws:
        async for raw in ws:
            e = json.loads(raw)
            if e.get('event') == 'roomInfo': continue
            d = e.get('data', {})
            nm = (d.get('user') or {}).get('nickname') or d.get('user_unique_id') or ''
            text = d.get('comment') or (f"sent {d['giftName']} x{d.get('repeatCount', 1)}" if d.get('giftName') else '')
            print(f"[{e.get('event')}] {nm} {text}")

asyncio.run(main())

<!DOCTYPE html>
<!-- Save as live-events.html and double-click. No build step. Swap KEY for your own key. -->
<meta charset="utf-8">
<title>Tik.Tools live events</title>
<style>
  body{font:14px ui-monospace,Menlo,monospace;background:#0a0a0c;color:#e4e4e7;padding:24px;max-width:760px;margin:0 auto}
  h1{font-size:18px;margin:0 0 8px}
  .bar{display:flex;gap:8px;margin:8px 0 14px}
  input,button{font:inherit;background:#14141a;color:#fff;border:1px solid #333;border-radius:6px;padding:6px 10px}
  button{background:#2a2a2a;border:none;cursor:pointer;font-weight:700}
  .row{padding:6px 10px;border-bottom:1px solid #222;display:flex;gap:10px;align-items:baseline}
  .type{font-size:11px;text-transform:uppercase;color:#d1d3d4;width:60px;flex-shrink:0}
  .user{color:#fff;font-weight:600}
  .msg{color:#9aa0a6;flex:1;overflow:hidden;text-overflow:ellipsis}
</style>
<h1>Live events monitor</h1>
<div class="bar">
  <input id="u" placeholder="username (empty = random live)" />
  <button id="go">Connect</button>
</div>
<div id="state">Enter a username or click Connect for a random live creator.</div>
<div id="feed"></div>
<script>
const API = 'https://api.tik.tools', WS = 'wss://api.tik.tools';
const KEY = 'your_api_key';   // <- swap for your free key at https://tik.tools

let ws = null;
async function connect() {
  if (ws) try { ws.close(); } catch {}
  feed.innerHTML = '';
  let user = u.value.trim().replace(/^@/, '');
  if (!user) {
    state.textContent = 'Picking a random live creator...';
    try {
      const r = await fetch(API + '/api/live/top-channels').then(r => r.json());
      user = (r.channels && r.channels[0] && r.channels[0].uniqueId) || '';
    } catch {}
    if (!user) { state.textContent = 'No live creators right now, try again in a minute.'; return; }
  }
  state.textContent = 'Connecting to @' + user + '...';

  const j = await fetch(API + '/authentication/jwt?apiKey=' + KEY, {
    method: 'POST', headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ allowed_creators: [user], expire_after: 600, max_websockets: 1 }),
  }).then(r => r.json());
  const token = j.data && j.data.token;
  if (!token) { state.textContent = 'Auth failed - get a free key at https://tik.tools'; return; }

  ws = new WebSocket(WS + '?uniqueId=' + user + '&jwtKey=' + encodeURIComponent(token));
  ws.onopen = () => state.textContent = '@' + user + ' - LIVE';
  ws.onmessage = ev => {
    const e = JSON.parse(ev.data);
    if (e.event === 'roomInfo' || !e.event) return;
    const d = e.data || {}, nm = (d.user && d.user.nickname) || d.user_unique_id || 'someone';
    const text = d.comment || (d.giftName ? 'sent ' + d.giftName + ' x' + (d.repeatCount || 1) : '');
    feed.insertAdjacentHTML('afterbegin',
      '<div class="row"><span class="type">' + e.event + '</span><span class="user">' + nm + '</span><span class="msg">' + text + '</span></div>');
    while (feed.children.length > 50) feed.removeChild(feed.lastChild);
  };
  ws.onclose = ev => { state.textContent = 'Closed: ' + (ev.reason || ev.code); };
}
go.onclick = connect;
// Auto-connect on load so the embedded preview starts streaming immediately.
connect();
</script>

Write me a minimal one-file program that connects to a TikTok LIVE stream using the Tik.Tools API + WebSocket gateway and prints every chat / gift / like / member event to the console. The program must:

1. Accept an optional CLI argument: the TikTok username to watch. If empty, hit GET https://api.tik.tools/api/live/top-channels (no auth, public, returns {channels:[{uniqueId,...}]}) and use channels[0].uniqueId.
2. Mint a short-lived JWT: POST https://api.tik.tools/authentication/jwt?apiKey=your_api_key with body {"allowed_creators":["<user>"],"expire_after":600,"max_websockets":1}. Response: {data:{token:"..."}}.
3. Open a WebSocket: wss://api.tik.tools?uniqueId=<user>&jwtKey=<token>
4. Each WS message is JSON shaped {event, data:{user:{nickname,uniqueId}, comment, giftName, repeatCount, viewerCount}}.

Constraints:
- Zero npm install / pip install except 'websockets' (Python only).
- One file. No build step. Stupid simple to copy/paste and run.
- The API key 'your_api_key' is a shared public demo key with a small daily cap shared by every user, so it is often exhausted. Put the key in one clearly marked constant so I can swap in my own: a free Sandbox account at https://tik.tools gives a personal key for a 7-day evaluation (no credit card), and paid plans continue from there with higher limits.

Pick the language I asked for and give me ONE working file. Comment the swap-the-key line + the username arg.

// stream-url.mjs
// Run: node stream-url.mjs                  (all live streams)
//      node stream-url.mjs aljazeeraenglish (filter to one)
// Prints HLS + FLV URLs. No auth. Pipe to mpv / ffplay / vlc.
const WANT = (process.argv[2] || '').replace(/^@/, '');
const r = await fetch('https://api.tik.tools/api/live/top-channels').then(r => r.json());
const list = WANT ? r.channels.filter(c => c.uniqueId === WANT) : r.channels;
if (!list.length) { console.log(WANT ? 'Not in current ticker: ' + WANT : 'No live channels'); process.exit(0); }
for (const c of list) {
  console.log('@' + c.uniqueId, '(' + c.region + ')');
  if (c.streamUrls?.hls) console.log('  HLS:', c.streamUrls.hls);
  if (c.streamUrls?.flv) console.log('  FLV:', c.streamUrls.flv);
  if (!c.streamUrls) console.log('  (no stream URL available)');
}

# stream_url.py
# Run: python stream_url.py                  (all live streams)
#      python stream_url.py aljazeeraenglish (filter to one)
import json, sys, urllib.request
WANT = (sys.argv[1] if len(sys.argv) > 1 else '').lstrip('@')
r = json.loads(urllib.request.urlopen('https://api.tik.tools/api/live/top-channels').read())
items = [c for c in r['channels'] if not WANT or c['uniqueId'] == WANT]
if not items: print('Not in current ticker' if WANT else 'No live channels'); sys.exit(0)
for c in items:
    print(f"@{c['uniqueId']} ({c['region']})")
    su = c.get('streamUrls') or {}
    if su.get('hls'): print('  HLS:', su['hls'])
    if su.get('flv'): print('  FLV:', su['flv'])
    if not su: print('  (no stream URL available)')

<!DOCTYPE html>
<!-- Save as live-video.html and double-click. Public endpoint, no signup. -->
<meta charset="utf-8">
<title>Tik.Tools live video</title>
<style>
  body{margin:0;background:#000;color:#fff;font:14px system-ui}
  video{width:100%;max-width:900px;display:block;margin:0 auto;background:#000}
  .bar{display:flex;gap:8px;justify-content:center;padding:10px}
  input,button{font:inherit;background:#14141a;color:#fff;border:1px solid #333;border-radius:6px;padding:6px 10px}
  button{background:#2a2a2a;border:none;cursor:pointer;font-weight:700}
  #info{padding:6px;text-align:center;color:#cbd5e1}
</style>
<div class="bar">
  <input id="u" placeholder="username (empty = random live)" />
  <button id="go">Play</button>
</div>
<div id="info">Pick any TikTok LIVE creator or leave empty for a random one.</div>
<video id="v" controls playsinline autoplay muted></video>
<script src="https://cdn.jsdelivr.net/npm/hls.js@latest"></script>
<script>
const API = 'https://api.tik.tools';
go.onclick = async () => {
  const wanted = u.value.trim().replace(/^@/, '');
  const r = await fetch(API + '/api/live/top-channels').then(r => r.json());
  let pick = null;
  if (wanted) {
    pick = (r.channels || []).find(c => c.uniqueId === wanted) || null;
    if (!pick) { info.textContent = '@' + wanted + ' not in current ticker. Try empty for random.'; return; }
  } else {
    pick = (r.channels || []).find(c => c.streamUrls && c.streamUrls.hls) || null;
    if (!pick) { info.textContent = 'No streams available right now.'; return; }
  }
  if (!pick.streamUrls || !pick.streamUrls.hls) { info.textContent = 'No stream URL for @' + pick.uniqueId; return; }
  info.textContent = '@' + pick.uniqueId + ' - LIVE';
  const hls = pick.streamUrls.hls;
  if (v.canPlayType('application/vnd.apple.mpegurl')) { v.src = hls; v.play(); }
  else if (window.Hls) { const h = new Hls(); h.loadSource(hls); h.attachMedia(v); }
};
go.click();
</script>

Write a minimal one-file program that plays a live TikTok stream in a <video> tag (HTML) or prints stream URLs (Node/Python) using the Tik.Tools public ticker. The program must:

1. Accept an optional CLI argument / input: TikTok username. If empty, pick the first channel from the ticker that has streamUrls.hls.
2. Call: GET https://api.tik.tools/api/live/top-channels (no auth, no signup, public). Response: {channels:[{uniqueId, displayName, region, roomId, streamUrls:{hls, flv}}], generatedAt, cachedFor}
3. For HTML, load hls.js from https://cdn.jsdelivr.net/npm/hls.js@latest. Safari plays HLS natively; Chrome/Firefox need hls.js.
4. The public ticker cache is 60s with 1 call per 5 min per IP. For per-creator live URLs without ticker-rate-limit, sign up free at https://tik.tools and use POST /webcast/room_video with a real API key.

Pick the language I asked for. One file. Zero dependencies (Safari) or one hls.js CDN script (Chrome). Stupid simple. Comment the username swap line.

// top-channels.mjs
// Run: node top-channels.mjs
// No auth. Public ticker - up to 10 currently-live creators. 1 call per 5 min per IP.
const r = await fetch('https://api.tik.tools/api/live/top-channels').then(r => r.json());
if (!r.channels?.length) { console.log('No live channels right now.'); process.exit(0); }
console.log(`Live now (${r.channels.length} channels):`);
for (const c of r.channels) console.log(`  @${c.uniqueId.padEnd(28)} ${c.region}  https://tik.tools/creator/@${c.uniqueId}`);

# top_channels.py
# Run: python top_channels.py
# Up to 10 currently-live creators. No auth.
import json, urllib.request
r = json.loads(urllib.request.urlopen('https://api.tik.tools/api/live/top-channels').read())
if not r.get('channels'): print('No live channels right now.'); raise SystemExit
print(f"Live now ({len(r['channels'])} channels):")
for c in r['channels']:
    print(f"  @{c['uniqueId']:<28} {c['region']:<8} https://tik.tools/creator/@{c['uniqueId']}")

<!DOCTYPE html>
<meta charset="utf-8">
<title>Tik.Tools top live channels</title>
<style>
  *{box-sizing:border-box}
  body{font:14px -apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,sans-serif;background:#0a0a0e;color:#e4e4e7;margin:0;padding:14px}
  .head{display:flex;justify-content:space-between;align-items:center;margin:0 0 10px;padding:0 4px}
  .head b{color:#fff;font-size:13px;font-weight:700;letter-spacing:.01em}
  .head .dot{display:inline-block;width:6px;height:6px;border-radius:50%;background:#22c55e;margin-right:6px;animation:pulse 1.4s ease-in-out infinite}
  .head span.cnt{color:#9aa0a6;font-size:11px}
  @keyframes pulse{0%,100%{opacity:1}50%{opacity:.3}}
  .row{display:flex;align-items:center;gap:10px;padding:9px 10px;border-bottom:1px solid #1a1a22;text-decoration:none;color:inherit;transition:background .15s}
  .row:hover{background:rgba(255,255,255,.03)}
  .row:last-child{border-bottom:none}
  .av{width:28px;height:28px;border-radius:50%;background:#2a2a2a;display:flex;align-items:center;justify-content:center;font-weight:700;color:#fff;flex-shrink:0;font-size:12px}
  .who{flex:1;min-width:0;display:flex;flex-direction:column;gap:1px}
  .who .nm{color:#fff;font-weight:600;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;font-size:13px}
  .who .h{color:#9aa0a6;font-size:11px;font-family:ui-monospace,Menlo,monospace}
  .reg{font-size:10px;font-weight:700;letter-spacing:.05em;color:#d1d3d4;background:rgba(255,255,255,0.06);border:1px solid rgba(255,255,255,0.14);padding:3px 7px;border-radius:999px;flex-shrink:0}
  .empty{color:#71717a;padding:20px;text-align:center;font-size:12px}
</style>
<div class="head"><b><span class="dot"></span>Top live channels right now</b><span class="cnt" id="cnt"></span></div>
<div id="list" class="empty">loading...</div>
<script>
fetch('https://api.tik.tools/api/live/top-channels').then(r => r.json()).then(d => {
  const ch = (d && d.channels) || [];
  if (!ch.length) { list.innerHTML = '<div class="empty">no live channels right now</div>'; return; }
  cnt.textContent = ch.length + ' live now';
  const esc = s => (s||'').replace(/[&<>"']/g, c => ({'&':'&amp;','<':'&lt;','>':'&gt;','"':'&quot;',"'":'&#39;'}[c]));
  list.classList.remove('empty');
  list.innerHTML = ch.map(c => {
    const u = esc(c.uniqueId), nm = esc(c.displayName || c.uniqueId), reg = esc(c.region || '');
    const initial = (c.uniqueId||'?')[0].toUpperCase();
    return '<a class="row" href="https://tik.tools/creator/@' + u + '" target="_blank" rel="noopener">'
      + '<span class="av">' + initial + '</span>'
      + '<span class="who"><span class="nm">' + nm + '</span><span class="h">@' + u + '</span></span>'
      + '<span class="reg">' + reg + '</span>'
      + '</a>';
  }).join('');
}).catch(() => { list.innerHTML = '<div class="empty">failed to load</div>'; });
</script>

Write a minimal one-file program that calls the Tik.Tools public ticker GET https://api.tik.tools/api/live/top-channels and prints the up-to-10 currently-live TikTok creator usernames + their region + the public Tik.Tools creator profile URL (https://tik.tools/creator/@{uniqueId}). The endpoint:

- No authentication, no signup, public CORS-enabled
- Response shape: { channels: [{ uniqueId, displayName, region, roomId, streamUrls:{hls,flv} }], generatedAt, cachedFor }
- Rate limit: 1 call per 5 minutes per IP. 429 with Retry-After on overage.

Use built-in fetch (HTML/Node) or urllib (Python). Pick the language I asked for. Tell me at the end that for unlimited access + WebSocket event streams + signed video stream URLs, sign up free at https://tik.tools.