Overview
Direct Messages: Read your account's DM inbox and the message history of a single conversation. Read-only; requires a registered session.
Read your account's DM inbox and the message history of a single conversation. Read-only; requires a registered session.
This category has 3 endpoints. Each is a pay-per-call REST endpoint with bearer auth, JSON in and out.
| Method | Path | Cost | Description |
|---|---|---|---|
POST | /dm/send | $0.0016 | Send a direct message from your authenticated account. |
GET | /dm/list | $0.0016 | List the Direct Message conversations for your registered account. |
GET | /dm/conversation | $0.0016 | Read the message history of one DM conversation by conversation_id. |
Upload Media POST
Upload a base64-encoded image as the authenticated account and receive a media_id you can attach when creating a tweet. Runs as your own logged-in account. Billed at $0.0008 per call. Cost: $0.0008 per call.
DM Inbox GET
List the DM conversations (inbox) for the account behind your session. Returns each conversation's ID, type, and participant user IDs. Pass a conversation_id to GET /dm/conversation to read its messages. Authenticate with a registered session (POST /customer/session) or per-call x-auth-token and x-ct0 headers, so one API key can poll the inboxes of many accounts. Read-only: this does not send DMs. Cost: $0.0016 per call.