Live
List Live Chat
Read a stream’s chat, newest page first, then poll for new messages.
GET
List Live Chat
Read a stream’s chat. The chat stays between broadcasts, so it can be read while the user is offline.
Behavior
- Without
after, returns the newest 50 messages, oldest first. Poll withafterset to the previous response’slast_idto get only new messages, again oldest first and up to 50 at a time.last_idcounts messages that were left out, so a run of hidden messages never stalls your polling. - Pass the previous response’s
nowassinceto learn which messages were removed since then: their ids come back inremoved, at most 50. Drop them, or fetch the chat again to see them as removed; if 50 came back, fetch the chat again withoutafterto catch any beyond that. See Pagination. - A removed message has
deleted: trueandbody: null.deleted_bynames who removed it, but only for the streamer, their moderators and staff; everyone else getsnull. Messages deleted by their own author are left out entirely. roleisstreamerormoderatorfor those authors, otherwisenull.reply_toquotes the message being replied to, withbody: nullanddeleted: trueif that message was removed. It isnullif that message’s author deleted it.- Messages from users you blocked or who blocked you, and from suspended users, are left out.
restrictedistimed_outorbannedwhile that author is timed out or banned from this chat, otherwisenull. It is only included for the streamer, their moderators and staff.restrictionsays whether you yourself are timed out or banned here, withexpires_atfor a timeout andnullfor a ban. It isnullwhen you can chat.- While the streamer has the chat turned off,
chat_messagesandremovedare empty. - If the streamer blocked you, the response is
403with typeblocked.
Example
Query Parameters
Response
Success.