Send Chat

Send a chat message to a live TikTok room as the logged-in user. The server signs, joins the room, sends, and confirms the message actually appeared in the live chat.

POST /chat-send

Send a chat message to a live TikTok room on behalf of an authenticated user. One call - the server signs the request, joins the room, sends the message, and confirms it actually appeared in the live chat. Returns the real delivery result, not just TikTok’s status code.

Authentication: include TikTok session cookies via the x-cookie-header header. The minimum required is sessionid + tt-target-idc. Get them from browser DevTools -> Application -> Cookies -> tiktok.com (tt-target-idc is the data-center cookie, e.g. eu-ttp2, useast5).

Use a real, established account. Brand-new TikTok accounts (auto usernames like user35441..., no avatar/nickname/posts, or under ~24h old) are auto-shadowbanned from live chat by TikTok - they return delivered: false no matter what. An aged, complete account is required.

delivered is the truth. TikTok returns status_code: 0 even on messages it silently shadow-drops. This endpoint subscribes to the room’s live event stream and confirms your exact message text appeared, then reports delivered: true / false. Do not rely on status_code alone.

Parameters

Parameter	Type	Required	Description
channel	string	Yes	The live creator’s @username (the server resolves the current room)
text	string	Yes	Chat message text (max ~150 chars)

Response

{
  "delivered": true,
  "status_code": 0,
  "msg_id": "7650032344963615510",
  "channel": "creatorname",
  "room": "7650027009598442262",
  "confirmed_via": "live-event"
}

delivered: false with an aged account usually means the creator restricted chat (followers-only / mod-only / chat off), or your account is rate-limited - try another live or slow down.

Examples

Node.js

const res = await fetch('https://api.tik.tools/chat-send?apiKey=YOUR_KEY', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-cookie-header': 'sessionid=YOUR_SESSIONID; tt-target-idc=eu-ttp2'
  },
  body: JSON.stringify({ channel: 'creatorname', text: 'Hello!' })
});
console.log(await res.json()); // { delivered: true, msg_id: '...', confirmed_via: 'live-event' }

Migrating from /webcast/chat? The older endpoint returned a signed_url for you to POST yourself, which TikTok shadow-drops unless you also replicate the room-join handshake. /chat-send does the join + send + delivery confirmation server-side - switch to it and pass tt-target-idc alongside sessionid.