Developer API reference

Connect a tool

All-Chat aggregates live chat from Twitch, YouTube, Kick, TikTok and Discord into a single normalized stream — every message, plus platform events like subs, bits, raids, super chats and gifts, in one format, with 7TV/BTTV/FFZ emotes resolved for you. The same stream that powers the browser overlay is the one your tool reads.

Open a WebSocket to the overlay endpoint. Reading the stream is anonymous— no token or account is required (this is the same "OBS mode" the browser overlay uses):

wss://allch.at/ws/overlay/{overlay_id}

Your overlay_idis the UUID in your overlay's browser-source URL. Want to try without an account first? Use the public test overlay.

Query parameters

Minimal example (JavaScript)

const ws = new WebSocket(
  "wss://allch.at/ws/overlay/00000000-0000-4000-8000-000000000a11"
)

ws.onmessage = (e) => {
  const msg = JSON.parse(e.data)
  switch (msg.type) {
    case "chat_message":
    case "message_update": {
      const d = msg.data
      if (d.event) {
        console.log("event", d.platform, d.event.type, d.event.value?.display_text)
      } else {
        console.log("chat", d.platform, d.user.display_name + ":", d.message.text)
      }
      break
    }
    case "ping":
      ws.send(JSON.stringify({ type: "pong" }))
      break
    case "connected":
    case "platform_status":
      break
  }
}

Minimal example (Python)

# pip install websocket-client
import json, websocket

def on_message(ws, raw):
    msg = json.loads(raw)
    if msg["type"] in ("chat_message", "message_update"):
        d = msg["data"]
        if d.get("event"):
            print("event", d["platform"], d["event"]["type"])
        else:
            print("chat", d["platform"], d["user"]["display_name"], d["message"]["text"])
    elif msg["type"] == "ping":
        ws.send(json.dumps({"type": "pong"}))

ws = websocket.WebSocketApp(
    "wss://allch.at/ws/overlay/00000000-0000-4000-8000-000000000a11",
    on_message=on_message,
)
ws.run_forever()

Message format

Every frame is JSON with the same envelope:

{
  "type": "chat_message",
  "data": { ... },          // shape depends on "type" (omitted for ping/pong)
  "timestamp": "2026-06-18T14:30:00Z"
}

type is one of:

Chat messages

For chat_message and message_update, data is the unified message object:

user

message, emotes, and attachments

message is { "text": string, "emotes": Emote[], "attachments"?: Attachment[] }. Each Emote:

attachments is present only when a message carries media (Discord image/GIF/video uploads and Tenor/Giphy link previews today). Each Attachment:

Each Badge is { "name", "version", "icon_url" } — e.g. { "name": "subscriber", "version": "12", "icon_url": "..." }.

Example

{
  "type": "chat_message",
  "data": {
    "id": "abc123",
    "overlay_id": "00000000-0000-4000-8000-000000000a11",
    "platform": "twitch",
    "channel_id": "12345",
    "channel_name": "examplestreamer",
    "user": {
      "id": "67890",
      "username": "viewer123",
      "display_name": "Viewer123",
      "color": "#1E90FF",
      "badges": [{ "name": "subscriber", "version": "12", "icon_url": "https://.../sub.png" }]
    },
    "message": {
      "text": "that was insane PogChamp",
      "emotes": [
        { "code": "PogChamp", "provider": "twitch", "url": "https://.../pogchamp.png", "positions": [[13, 20]] }
      ]
    },
    "timestamp": "2026-06-18T14:30:00Z",
    "metadata": {}
  },
  "timestamp": "2026-06-18T14:30:00Z"
}

Events

Platform events (subs, bits, raids, donations, …) arrive as chat_message frames whose data includes an event object. Normal chat has no event field.

Event types by platform

• Twitch: subscription, resubscription, gift_subscription, mystery_gift, bits, raid, channel_points, message_deletion
• YouTube: super_chat, super_sticker, new_sponsor, member_milestone, membership_gift, gift_received
• TikTok: gift, like_aggregate, follow, share

Example (Twitch subscription)

{
  "type": "chat_message",
  "data": {
    "id": "evt-sub-1",
    "overlay_id": "00000000-0000-4000-8000-000000000a11",
    "platform": "twitch",
    "channel_id": "12345",
    "channel_name": "examplestreamer",
    "user": { "id": "999", "username": "newsub", "display_name": "NewSub", "badges": [] },
    "message": { "text": "just subscribed!", "emotes": [] },
    "timestamp": "2026-06-18T14:35:00Z",
    "metadata": {},
    "event": {
      "type": "subscription",
      "tier": "medium",
      "duration": 8,
      "is_update": false,
      "value": { "amount": 1, "currency": "months", "display_text": "Tier 1 sub" }
    }
  },
  "timestamp": "2026-06-18T14:35:00Z"
}

Status & control messages

On connect the server sends a connected frame, then a platform_status frame per configured source so your UI can show indicators immediately. platform_status data:

Reconnecting & heartbeats

• The server periodically sends { "type": "ping" }. Reply with { "type": "pong" }. (Most WebSocket libraries also answer low-level ping frames automatically.)
• If the socket drops, reconnect with backoff. To backfill messages missed during a brief disconnect, reconnect with ?since=<ms-epoch> set to just before you lost the connection — the server replays buffered messages newer than that timestamp.
• Treat IDs as the dedup key when combining the replay buffer with live messages.

Try it now (no setup)

There is a public test overlay that streams realistic fake traffic — random chat, poll votes (the literal messages 1, 2, 3, 4) and platform events — so you can build and validate an integration without an account or a real channel. Just connect; traffic flows while a client is connected and stops when the last one disconnects:

wss://allch.at/ws/overlay/00000000-0000-4000-8000-000000000a11

Drop that URL into either example above and you should immediately see messages and events stream in.