One-line migration

Move from TikAPI to Tik.Tools in 30 seconds

Same endpoints. Same response shape. Real-time WebSocket events on top. Swap the base URL, keep your code.

// 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. No signup. -->
<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="status">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) {
    status.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) { status.textContent = 'No live creators right now, try again in a minute.'; return; }
  }
  status.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) { status.textContent = 'Auth failed - get a free key at https://tik.tools'; return; }

  ws = new WebSocket(WS + '?uniqueId=' + user + '&jwtKey=' + encodeURIComponent(token));
  ws.onopen = () => status.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 => { status.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 the public demo - works without signup, 10-min sessions, 1 concurrent WS, strict per-IP daily caps. For production, sign up free at https://tik.tools to get a real key with higher limits + access to /webcast/* endpoints.

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

Get free API key

Live preview

Same TikAPI shape, served from api.tik.tools

The iframe below is the literal HTML example file - it pulls live channels from /api/live/top-channels and streams events via WebSocket. Copy it, save as .html, double-click. Identical output.

live-events.htmlRUNNING

Preview loads once visible.

// 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. No signup. -->
<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="status">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) {
    status.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) { status.textContent = 'No live creators right now, try again in a minute.'; return; }
  }
  status.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) { status.textContent = 'Auth failed - get a free key at https://tik.tools'; return; }

  ws = new WebSocket(WS + '?uniqueId=' + user + '&jwtKey=' + encodeURIComponent(token));
  ws.onopen = () => status.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 => { status.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 the public demo - works without signup, 10-min sessions, 1 concurrent WS, strict per-IP daily caps. For production, sign up free at https://tik.tools to get a real key with higher limits + access to /webcast/* endpoints.

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

Node / Python / HTML / LLM prompt

Change one line

Point your existing TikAPI base URL at https://api.tik.tools. The path stays the same.

// Before
const BASE = 'https://api.tikapi.io';

// After
const BASE = 'https://api.tik.tools';

Use your Tik.Tools API key

Get one free at tik.tools/login. Pass it as ?apiKey= or X-API-Key: header - both work.

fetch(`${BASE}/live/check?username=aljazeeraenglish&apiKey=tk_xxxx`)

That's it

Your existing handlers keep working. Every migration response carries a _tiktool hint pointing at the native endpoint - switch when you're ready for faster + richer data.

Endpoint map

Every TikAPI live-data call works against Tik.Tools

VOD, profile metadata, and search are TikAPI-only - we are a TikTok LIVE specialist. Everything below is a drop-in.

TikAPI endpoint	Tik.Tools (compat)	Native equivalent	Tier
`GET /live/check?username=X`	`GET /live/check?username=X`	`POST /webcast/room_id`	Free
`GET /live/check/list?usernames=A,B`	`GET /live/check/list?usernames=A,B`	`POST /webcast/bulk_live_check`	Basic+
`GET /live/info?room_id=X`	`GET /live/info?room_id=X`	`POST /webcast/room_info`	Free
`GET /live/info?username=X`	`GET /live/info?username=X`	`POST /webcast/room_id` + `/webcast/room_info`	Free
`GET /live/details/:room_id`	`GET /live/details/:room_id`	`POST /webcast/room_info`	Free
`POST /live/chat`	`POST /live/chat`	`POST /webcast/chat`	Basic+
`GET /users/:name/videos`	`GET /users/:name/videos`	returns empty + live status	Free
`GET /user/info?username=X`	`GET /user/info?username=X`	returns user + live status	Free
`GET /search/videos \| /search/users`	`GET /search/*`	returns empty + note	Free
`GET /hashtag/:tag \| /trending`	`GET /hashtag/* \| /trending`	returns empty + note	Free
`GET /video/list \| /video/:id`	`GET /video/*`	returns empty + note	Free
Bonus (not in TikAPI): real-time WS events for chat / gifts / likes / joins / battles		`wss://api.tik.tools`	Free (15 conn)
Bonus: AI live captions + translation (60+ languages)		`POST /webcast/captions`	Basic+
Bonus: creator + gifter leaderboards (28 regions)		`/api/leaderboards/*`	Free

VOD endpoints don't crash your code: /users/x/videos, /search/*, /hashtag/*, /video/*, /trending, /comment/* all return HTTP 200 with empty arrays + a _tiktool note. The user-shaped endpoints also include live_status so your migration script keeps shipping. Keep TikAPI for actual VOD data; we cover everything LIVE.

Response shape

Identical JSON, plus a migration hint

Every compat response carries a _tiktool envelope so you know exactly which native endpoint to call when you're ready to switch.

GET https://api.tik.tools/live/check?username=aljazeeraenglish&apiKey=tk_xxxx

{
  "username": "aljazeeraenglish",
  "is_live": true,
  "live": true,
  "room_id": "7643424275830934286",
  "roomId": "7643424275830934286",
  "_tiktool": {
    "native_endpoint": "POST /webcast/room_id { unique_id: 'aljazeeraenglish' }",
    "note": "Migration shim. Switching to the native endpoint above unlocks lower latency + richer fields.",
    "upgrade": "https://tik.tools/pricing",
    "guide": "https://tik.tools/guides/migrate-from-tikapi"
  }
}

Free tier is enough to migrate + test

2,500 REST requests/day. 15 concurrent WebSocket connections. No credit card. Upgrade only when you ship.

Get free API key Read full docs