Skip to main content
POST
Get DM Media (XChat v3)

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Fetch one XChat media attachment and return a playable URL.

conversation_id
string
required

Conversation id from /v3/twitter/dm-history

Example:

"1928096185664843776:1989842918455291904"

media_hash_key
string
required

Attachment media_hash_key from dm-history

Example:

"blRIlZCVIO"

Twitter authentication cookie or Twitter auth_token, how-to-get-twitter-cookie

Example:

"ct0=abc123... or 2c4a4e1832096aa694c739b83c83b6d96d43eba7"

key_version
string | null

Optional message key_version from dm-history (recommended).

Example:

"3"

type_name
string | null

Optional IMAGE/VIDEO/GIF hint

Example:

"VIDEO"

filename
string | null

Optional filename hint

Example:

"clip.mp4"

pin
string | null
default:1234

Identity PIN (default 1234).

Example:

"1234"

proxy
string | null

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

Example:

"http://username:password@ip:port"

Response

Playable media URL and metadata.

code
integer
required

Response code

Example:

200

msg
string
required

Response message

Example:

"success"

data
GetDmMediaV3Data · object | null

Media info