Chatous Get Account State

PythonSocial Media
POST api.upapi.io/chatous-get-account-state.get

Read a Chatous account's own profile, its open conversations and their message history in one bounded WebSocket read. Chatous exposes no REST endpoint for any of this, so the socket's opening burst is the only source.

chatousprofileconversationsmessages
AuthAPI key
Cost4 units
Timeout40s
CacheNone

Request schema

FieldTypeDescription
proxyUrl
Optional proxy URL for the WebSocket. Omit to connect directly. Pass the exit the account normally uses if you keep one per account.· default: null
connectSidreq
stringThe account's connect.sid cookie value, as set on chatous.com when the account signed in.
maxSeconds
numberHow long to hold the socket open collecting the opening burst. Raise it for an account with many conversations; the call returns early once the server stops sending.· default: 12
maxMessages
integerCap on collected socket frames, so a very busy account cannot stream on.· default: 300

Response schema

FieldTypeDescription
profilereq
The account's own profile as Chatous pushed it, or null when the burst carried none. Null means 'not sent in this window', never 'no profile'.
messagesreq
arrayMessage history for the conversations above, oldest first as received.
elapsedMsreq
integer
fetchedAtreq
string
frameCountreq
integerRaw socket frames collected, before classification.
messageCountreq
integer
socketOpenedreq
boolean
conversationsreq
array
conversationCountreq
integer
undecodableItemCountreq
integerSocket items this build could not read. Non-zero means the platform's frame shape has changed and this answer is INCOMPLETE - the account may hold conversations that are missing from the lists above.

Try it

Try it

The account's connect.sid cookie value, as set on chatous.com when the account signed in.

Optional proxy URL for the WebSocket. Omit to connect directly. Pass the exit the account normally uses if you keep one per account.

How long to hold the socket open collecting the opening burst. Raise it for an account with many conversations; the call returns early once the server stops sending.

Cap on collected socket frames, so a very busy account cannot stream on.

Run this endpoint live

Jump in as a guest — no signup — and run chatous-get-account-state.get with your own inputs. Create a free account anytime to get your own API key.

Sign in

Code examples

curl -X POST https://api.upapi.io/chatous-get-account-state.get \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_API_KEY' \
  -d '{ "connectSid": "example", "maxSeconds": 12, "maxMessages": 300 }'

Developer tools

OpenAPI specImport the spec or collection into Postman, Insomnia, or any codegen tool.