Twitter Write API | Like, Retweet, Bookmark, Follow
Write Actions: Act on behalf of an authenticated account: post, delete, like, retweet, bookmark and follow, each with its undo, plus the compose surface (private drafts and scheduled posts). MOST of these bill at $0.0008 per call, the same as a standard read, but not all: tweet/create, draft/create, draft/edit, draft/list, scheduled/create and scheduled/list are $0.0016. Read the price on the endpoint, never off this line.
Act on behalf of an authenticated account: post, delete, like, retweet, bookmark and follow, each with its undo, plus the compose surface (private drafts and scheduled posts). MOST of these bill at $0.0008 per call, the same as a standard read, but not all: tweet/create, draft/create, draft/edit, draft/list, scheduled/create and scheduled/list are $0.0016. Read the price on the endpoint, never off this line.
This category has 27 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 | /community/join | $0.0008 | Join an open X Community as your own account. |
POST | /community/leave | $0.0008 | Leave an X Community as your own account. |
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. |
POST | /user/update_profile | $0.0016 | Change your own display name, bio, location or link. A PARTIAL update. |
POST | /user/update_avatar | $0.0016 | Replace your own profile picture with a base64-encoded image. |
POST | /user/update_banner | $0.0016 | Replace your own profile header image with a base64-encoded image. |
POST | /draft/create | $0.0016 | Save a private draft on your own account. Nothing is posted. |
POST | /draft/edit | $0.0016 | Replace the contents of an existing draft on your own account. |
POST | /draft/delete | $0.0008 | Delete a draft from your own account by ID. |
GET | /draft/list | $0.0016 | List the drafts saved on your own account. |
POST | /scheduled/create | $0.0016 | Schedule a tweet to post publicly at a future instant. |
POST | /scheduled/delete | $0.0008 | Cancel a scheduled tweet before it posts. |
GET | /scheduled/list | $0.0016 | List the posts queued to publish on your own account. |
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.
Join Community
Join an open X Community as your own account.
Leave Community
Leave an X Community as your own account.
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.
Update Profile
Change your own display name, bio, location or link. A PARTIAL update.
Update Avatar
Replace your own profile picture with a base64-encoded image.
Update Banner
Replace your own profile header image with a base64-encoded image.
Create Draft Tweet
Save a private draft on your own account. Nothing is posted.
Edit Draft Tweet
Replace the contents of an existing draft on your own account.
Delete Draft Tweet
Delete a draft from your own account by ID.
List Draft Tweets
List the drafts saved on your own account.
Schedule Tweet
Schedule a tweet to post publicly at a future instant.
Cancel Scheduled Tweet
Cancel a scheduled tweet before it posts.
List Scheduled Tweets
List the posts queued to publish on your own account.
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.