Overview
Account Session: Bring your own X session cookies (recommended), or mint a session from a username and password, so write actions and private-data reads act as your account. Free.
Bring your own X session cookies (recommended), or mint a session from a username and password, so write actions and private-data reads act as your account. Free.
This category has 2 endpoints. Each is a pay-per-call REST endpoint with bearer auth, JSON in and out.
| Method | Path | Cost | Description |
|---|---|---|---|
POST | /customer/session | Free | Register your auth_token and ct0 cookies once so every write and private read acts as your account, or pass them per call as x-auth-token / x-ct0 headers. |
POST | /user/user_login | Free | Mint an X session from a username, password, and optional TOTP 2FA secret, returning auth_token, ct0, and twid. A convenience alternative to bringing your own cookies via Register Session. |
Register Session
Register your auth_token and ct0 cookies once so every write and private read acts as your account, or pass them per call as x-auth-token / x-ct0 headers.
User Login
Mint an X session from a username, password, and optional TOTP 2FA secret, returning auth_token, ct0, and twid. A convenience alternative to bringing your own cookies via Register Session.
Send DM POST
Send a direct message to a user as the authenticated account. Requires a logged-in session for the acting account. Billed at $0.0016 per call. Cost: $0.0016 per call.
Register Session POST
Register your X session cookies so write actions (like, retweet, bookmark, follow, create or delete a tweet) and private-data reads (home timeline, bookmarks, likes, DMs, followers-you-know) run as your account. Supply auth_token and ct0 once; the session is stored against your API key and applied automatically. This call is free. Cost: Free per call.