Миграция в одну строку

Переезд с TikAPI на Tik.Tools за 30 секунд

Те же эндпоинты. Тот же формат ответа. А сверху - события в реальном времени через WebSocket. Замените базовый URL, код оставьте.

// 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.

Получить бесплатный API-ключ

Живой предпросмотр

Тот же формат TikAPI, но с api.tik.tools

Iframe ниже - это тот самый HTML-файл примера: он берёт каналы в эфире из /api/live/top-channels и стримит события через WebSocket. Скопируйте, сохраните как .html, откройте двойным щелчком. Результат идентичный.

live-events.htmlРАБОТАЕТ

Предпросмотр загрузится, когда блок появится на экране.

// 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.

Node / Python / HTML / промпт для LLM

Измените одну строку

Направьте ваш текущий базовый URL TikAPI на https://api.tik.tools. Путь остаётся прежним.

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

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

Используйте API-ключ Tik.Tools

Получите его бесплатно на tik.tools/login. Передавайте как ?apiKey= или в заголовке X-API-Key: - работают оба варианта.

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

Вот и всё

Ваши обработчики продолжают работать. Каждый ответ в режиме миграции содержит подсказку _tiktool с нативным эндпоинтом - переходите на него, когда захотите более быстрые и богатые данные.

Карта эндпоинтов

Все вызовы TikAPI для живых данных работают с Tik.Tools

VOD, метаданные профилей и поиск есть только в TikAPI - мы специализируемся на TikTok LIVE. Всё, что ниже, - прямая замена.

Эндпоинт TikAPI	Tik.Tools (совместимость)	Нативный аналог	Тариф
`GET /live/check?username=X`	`GET /live/check?username=X`	`POST /webcast/room_id`	Бесплатно
`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`	Бесплатно
`GET /live/info?username=X`	`GET /live/info?username=X`	`POST /webcast/room_id` + `/webcast/room_info`	Бесплатно
`GET /live/details/:room_id`	`GET /live/details/:room_id`	`POST /webcast/room_info`	Бесплатно
`GET /users/:name/videos`	`GET /users/:name/videos`	возвращает пустой ответ + статус эфира	Бесплатно
`GET /user/info?username=X`	`GET /user/info?username=X`	возвращает пользователя + статус эфира	Бесплатно
`GET /search/videos \| /search/users`	`GET /search/*`	возвращает пустой ответ + пометку	Бесплатно
`GET /hashtag/:tag \| /trending`	`GET /hashtag/* \| /trending`	возвращает пустой ответ + пометку	Бесплатно
`GET /video/list \| /video/:id`	`GET /video/*`	возвращает пустой ответ + пометку	Бесплатно
Бонус (нет в TikAPI): события WS в реальном времени: чат / подарки / лайки / входы / баттлы		`wss://api.tik.tools`	Бесплатно (15 подкл.)
Бонус: рейтинги стримеров и дарителей (регионов: 44)		`/api/leaderboards/*`	Бесплатно

VOD-эндпоинты не ломают ваш код: /users/x/videos, /search/*, /hashtag/*, /video/*, /trending, /comment/* возвращают HTTP 200 с пустыми массивами и пометкой _tiktool. Эндпоинты с данными пользователя также содержат live_status, так что ваш скрипт миграции продолжит работать. Для настоящих VOD-данных оставьте TikAPI; всё, что связано с LIVE, берём на себя мы.

Формат ответа

Тот же JSON плюс подсказка по миграции

Каждый ответ в режиме совместимости содержит обёртку _tiktool, так что вы точно знаете, какой нативный эндпоинт вызывать, когда будете готовы перейти.

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"
  }
}

Бесплатного тарифа хватит на миграцию и тесты

5 000 REST-запросов в день. 3 одновременных WebSocket-подключения, 50 сессий в день. Без банковской карты. Платный тариф - только когда выйдете в продакшен.

Получить бесплатный API-ключ Читать документацию