Get Conversations (XChat v3)

Get XChat conversation list. Use count for page size (10–200). Set all=true to follow the inbox cursor and return every conversation.

Back to API Reference

/DM Endpoints

TwexAPI REST

POST/v3/twitter/conversations

Authorization

AuthorizationBearer token · headerrequired

Global API Bearer Token for TwexAPI. Included as: Authorization: Bearer <YOUR_TWEXAPI_KEY>.

Request Body

requiredapplication/json

countinteger | any

Max conversations per page (10–200, default 20).

default: 100

Show properties

Any of:

integer

integer

any

any

allboolean | any

Follow the inbox cursor and return every conversation (may be slow).

default: false

Show properties

Any of:

boolean

boolean

any

any

cookiestringrequired

The user's own authorized Twitter session credentials or auth_token (BYOC — Bring Your Own Cookie). Stateless proxy execution with zero credential retention. See [Authentication Security](/authentication#write-operations--byoc-bring-your-own-cookie) and [How to get Cookie](https://youtube-promotion.pages.dev/how-to-get-twitter-cookie).

proxystring | any

Optional HTTP proxy. Example: http://username:password@ip:port

Show properties

Any of:

string

string

any

any

Responses

200A list of conversation objects.

codeintegerrequired

Response code

msgstringrequired

Response message

dataConversationV3Model[]required

Conversation list

Show properties

Array of ConversationV3Model

conversation_idstringrequired

Conversation id

typestringrequired

Conversation type: direct or group

is_mutedbooleanrequired

Whether the conversation is muted

participantsstring[]required

Participant user ids

422Validation Error

detailValidationError[]

Show properties

Array of ValidationError

locstring | integer[]required

Show properties

Array of string | integer

Any of:

string

string

integer

integer

msgstringrequired

typestringrequired

inputany

ctxobject

⚡Interactive Console / Try APIPOST/v3/twitter/conversations

Live Console

🌐Target Server:https://api.twexapi.io

● Production Ready

✍️

Write Operation Credentials Guide (TwexAPI Key + Twitter Cookie)

1. TwexAPI Platform Key (Bearer Token): Enter under "API Authorization" below for request billing & authentication.

2. Twitter Account Cookie: For write operations (tweet, like, follow, etc.), provide the target Twitter account's Cookie (e.g. auth_token=...; ct0=...) in the cookie field of Request Body below.

🔑API Authorization

Remember keySync to code samples

TwexAPI Platform Key Bearer TokenRequired

Global API key used across all TwexAPI endpoints. Get it from the console.

📝Request Bodyapplication/json

countstring

OptionalMax conversations per page (10–200, default 20).

allstring

OptionalFollow the inbox cursor and return every conversation (may be slow).

cookiestringTwitter Account Cookie / Auth Token

RequiredThe user's own authorized Twitter session credentials or auth_token (BYOC — Bring Your Own Cookie). Stateless proxy execution with zero credential retention. See [Authentication Security](/authentication#write-operations--byoc-bring-your-own-cookie) and [How to get Cookie](https://youtube-promotion.pages.dev/how-to-get-twitter-cookie).

proxystring

OptionalOptional HTTP proxy. Example: http://username:password@ip:port

💡 Quick send:⌘ / Ctrl+Enter

📡

No Response Yet

Configure parameters in the Request tab and click Send Request below.

Request

curl -X POST "https://api.twexapi.io/v3/twitter/conversations" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "count": 100,
  "all": true,
  "cookie": "ct0=abc123... or 2c4a4e1832096aa694c739b83c83b6d96d43eba7",
  "proxy": "http://username:password@ip:port"
}'

const response = await fetch("https://api.twexapi.io/v3/twitter/conversations", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
  "count": 100,
  "all": true,
  "cookie": "ct0=abc123... or 2c4a4e1832096aa694c739b83c83b6d96d43eba7",
  "proxy": "http://username:password@ip:port"
})
});

import requests

response = requests.post(
    "https://api.twexapi.io/v3/twitter/conversations",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Content-Type": "application/json"
    },
    json={
  "count": 100,
  "all": True,
  "cookie": "ct0=abc123... or 2c4a4e1832096aa694c739b83c83b6d96d43eba7",
  "proxy": "http://username:password@ip:port"
},
)

Response

{
  "code": 200,
  "msg": "success",
  "data": [
    {
      "conversation_id": "1928096185664843776:1989842918455291904",
      "type": "direct",
      "is_muted": false,
      "participants": [
        "1928096185664843776"
      ]
    }
  ]
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}