Kubo Live

Kubo Live is an API platform, not a ready-made game, effects app or historical analytics service.

1. 01

   Sign in

   Use your existing Kubo Live account to open the console.

2. 02

   Create a key

   Create an API key for your server and keep it private.

3. 03

   Connect a creator

   Request a short-lived token for the creator, then open the returned WebSocket URL.

4. 04

   Handle events

   Read incoming events and add your own application logic.

// Run on this site's origin after signing in.
const { wsUrl } = await createLiveToken('YOUR_CREATOR');
const socket = new WebSocket(wsUrl);
socket.onmessage = ({ data }) => {
  const packet = JSON.parse(data);
  for (const event of packet.messages ?? []) {
    console.log(event.type, event.data);
  }
};
socket.onerror = () => console.error('Connection error');
socket.onclose = ({ code }) => console.log('Closed', code);
// Call socket.close() when your application stops listening.

async function createLiveToken(account) {
  const session = await fetch('/api/auth/session', {
    credentials: 'include'
  }).then(response => response.json());
  if (!session.authenticated || !session.csrf) {
    throw new Error('Sign in first');
  }
  const response = await fetch('/api/tokens', {
    method: 'POST',
    credentials: 'include',
    headers: {
      'Content-Type': 'application/json',
      'X-CSRF-Token': session.csrf
    },
    body: JSON.stringify({ account })
  });
  if (!response.ok) throw new Error('Token request failed');
  return response.json();
}

Paid subscriptions are not available yet.

Which live events can I receive?

Public TikTok LIVE rooms can provide comments, gifts, likes, follows and viewer joins. The events available depend on the room and live source. Message fields and gift quantities are explained in the docs.

Do I need to install TikTok or run a browser?

Not for managed WebSocket streaming. Your application connects to Kubo Live and receives the events. You do not need to run the TikTok app or keep a live page playing.

Can I connect from a server or a browser?

Yes. Keep your API key on your server. Browser clients use short-lived tokens issued for a selected creator. Node.js and Python integration examples are available in the docs.

How does the free allowance work?

Concurrent connections limit how many live sockets you can keep open. API requests are a daily allowance, with additional minute and hour limits. Alerts limit how many creators you monitor. The current plan values are shown above; your console shows your assigned limits and usage.

Can I register or buy a plan now?

Public registration and paid subscriptions are not open yet. Existing accounts can sign in. The integration docs are public and do not require an account.