Twitter Write API | Like, Retweet, Bookmark, Follow
Write Actions: Act on behalf of an authenticated account: like, retweet, bookmark, and follow, each with its undo. Billed at $0.0008 per call, the same as a standard read.
Act on behalf of an authenticated account: like, retweet, bookmark, and follow, each with its undo. Billed at $0.0008 per call, the same as a standard read.
This category has 15 endpoints. Each is a pay-per-call REST endpoint with bearer auth, JSON in and out.
| Method | Path | Cost | Description |
|---|---|---|---|
POST | /media/upload | $0.0008 | Upload an image and get a media_id to attach to a tweet. |
GET | /media/status | $0.0008 | Check the async processing state of an uploaded media_id. |
POST | /list/add_member | $0.0008 | Add one account to a Twitter/X List you own. |
POST | /list/remove_member | $0.0008 | Remove one account from a Twitter/X List you own. |
POST | /list/create | $0.0016 | Create a new Twitter/X List owned by your session. |
POST | /tweet/favorite | $0.0008 | Like (favorite) a tweet on behalf of an authenticated account. |
POST | /tweet/unfavorite | $0.0008 | Remove a like (unfavorite) from a tweet. |
POST | /tweet/retweet | $0.0008 | Retweet a tweet on behalf of an authenticated account. |
POST | /tweet/unretweet | $0.0008 | Remove a retweet from a tweet. |
POST | /tweet/bookmark | $0.0008 | Add a tweet to the authenticated account's bookmarks. |
POST | /tweet/unbookmark | $0.0008 | Remove a tweet from the authenticated account's bookmarks. |
POST | /user/follow | $0.0008 | Follow a user on behalf of an authenticated account. |
POST | /user/unfollow | $0.0008 | Unfollow a user on behalf of an authenticated account. |
POST | /tweet/create | $0.0016 | Post a tweet as your registered account: text, media, reply, or quote. |
POST | /tweet/delete | $0.0008 | Delete one of your registered account's tweets by ID or status URL. |
Upload Media
Upload an image and get a media_id to attach to a tweet.
Media Status
Check the async processing state of an uploaded media_id.
Add List Member
Add one account to a Twitter/X List you own.
Remove List Member
Remove one account from a Twitter/X List you own.
Create List
Create a new Twitter/X List owned by your session.
Like Tweet
Like (favorite) a tweet on behalf of an authenticated account.
Unlike Tweet
Remove a like (unfavorite) from a tweet.
Retweet
Retweet a tweet on behalf of an authenticated account.
Undo Retweet
Remove a retweet from a tweet.
Bookmark Tweet
Add a tweet to the authenticated account's bookmarks.
Remove Bookmark
Remove a tweet from the authenticated account's bookmarks.
Follow User
Follow a user on behalf of an authenticated account.
Unfollow User
Unfollow a user on behalf of an authenticated account.
Create Tweet
Post a tweet as your registered account: text, media, reply, or quote.
Delete Tweet
Delete one of your registered account's tweets by ID or status URL.
List Followers GET
Fetch a public List's followers by its numeric ID, cursor-paginated. Followers and members are different sets of people: members are the accounts the List owner added to it, followers are the accounts that subscribed to read it. A List with hundreds of members commonly has only a handful of followers, so a small count here is normal and is not a truncated page. next_cursor is null once X marks the roster complete. Cost: $0.0008 per call.
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.