twittrapi-com

twittrapi-com Account actions API

POST endpoints that act on your own X account with your session cookie and your own proxy. Never retried by the gateway.

GitHub OpenAPI

Operations 64

POST /client/create Post a tweet #
POST /client/reply Reply to a tweet #
POST /client/like Like a tweet #
POST /client/unlike Unlike a tweet #
POST /client/retweet Retweet #
POST /client/unretweet Undo a retweet #
POST /client/deleteTweet Delete a tweet #
POST /client/pin Pin a tweet #
POST /client/unpin Unpin a tweet #
POST /client/follow Follow a user #
POST /client/unfollow Unfollow a user #
POST /client/mute Mute a user #
POST /client/unmute Unmute a user #
POST /client/block Block a user #
POST /client/unblock Unblock a user #
POST /client/bookmark Bookmark a tweet #
POST /client/unbookmark Remove a bookmark #
POST /client/bookmarks List bookmarks #
POST /client/bookmarks/folders Bookmark folders #
POST /client/bookmarks/folder Tweets in a bookmark folder #
POST /client/bookmarks/search Search bookmarks #
POST /client/likes Your likes #
POST /client/blocked Blocked accounts #
POST /client/muted Muted accounts #
POST /client/followers-you-know Followers you know #
POST /client/home-timeline Home timeline #
POST /client/schedule-overview List scheduled tweets #
POST /client/schedule-delete Delete a scheduled tweet #
POST /client/media Upload an image #
POST /client/media/video Upload a video #
POST /client/media/status Media processing status #
POST /client/profile Update your profile #
POST /client/profile/image Change your profile picture #
POST /client/profile/banner Change your header image #
POST /client/report Report a tweet #
POST /client/communities/create Create a community #
POST /client/communities/remove Delete a community #
POST /premium/analyticsOverview Account analytics overview #
POST /client/lists/create Create a list #
POST /client/lists/update Update a list #
POST /client/lists/delete Delete a list #
POST /client/lists/members/add Add a list member #
POST /client/lists/members/remove Remove a list member #
POST /client/communities/join Join a community #
POST /client/communities/leave Leave a community #
POST /client/communities/memberships Your communities #
POST /client/drafts List drafts #
POST /client/drafts/create Create a draft #
POST /client/drafts/edit Edit a draft #
POST /client/drafts/delete Delete a draft #
POST /client/articles List articles #
POST /client/articles/get Read an article #
POST /client/articles/create Create an article #
POST /client/articles/update Update an article #
POST /client/articles/publish Publish an article #
POST /client/articles/unpublish Unpublish an article #
POST /client/articles/delete Delete an article #
POST /client/dm/inbox List conversations #
POST /client/dm/conversation Read a conversation #
POST /client/dm/conversation/info Conversation details #
POST /client/dm/conversation/disappearing Disappearing messages #
POST /client/dm/send Send a message #
POST /client/dm/settings DM settings #
POST /client/dm/settings/update Change DM settings #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/twittrapi-com/openapi/twittrapi-com-account-actions-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/twittrapi-com/json-schema/twittrapi-com-job-location-page-schema.json
📊
JSONSchema
https://artifacts.apis.io/twittrapi-com/json-schema/twittrapi-com-trend-location-page-schema.json
📊
JSONSchema
https://artifacts.apis.io/twittrapi-com/json-schema/twittrapi-com-community-page-schema.json
📊
JSONSchema
https://artifacts.apis.io/twittrapi-com/json-schema/twittrapi-com-trend-page-schema.json
📊
JSONSchema
https://artifacts.apis.io/twittrapi-com/json-schema/twittrapi-com-tweet-page-schema.json
📊
JSONSchema
https://artifacts.apis.io/twittrapi-com/json-schema/twittrapi-com-user-page-schema.json

Other Resources

🔗
APIsJSON
https://artifacts.apis.io/twittrapi-com/apis.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/twittrapi-com:twittrapi-com-account-actions-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

twittrapi-com-account-actions-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: TwittrAPI Account actions API
  version: 1.0.0
  summary: Public Twitter/X data over REST, priced per API call.
  description: 'TwittrAPI is a REST API for public Twitter/X data: users, tweets, search, followers, lists, communities, jobs and trends. Pay per call from a prepaid balance; no X developer account needed.


    Authentication: send your key in the X-API-KEY header. Get a key at https://www.twittrapi.com/start (a human signs up; the key can then be given to an agent).


    Responses: X''s raw JSON by default (passthrough), or add format=simple for compact, flat JSON with a fixed schema (same price).


    Account actions (tag "Account actions", /client/* and /premium/*): POST endpoints that act on your own X account with its session cookie and your proxy in the JSON body (https://www.twittrapi.com/docs/x-session). Same price per call as reads; trial keys cannot call them.


    Pricing (machine-readable): https://www.twittrapi.com/pricing.json. All docs in one file: https://www.twittrapi.com/llms-full.txt.


    RapidAPI: the same paths on https://twitter-aio.p.rapidapi.com with the x-rapidapi-key and x-rapidapi-host headers.


    Not affiliated with X Corp. Twitter and X are trademarks of X Corp. Only publicly available data is accessible.'
  contact:
    name: TwittrAPI support
    email: support@twittrapi.com
    url: https://www.twittrapi.com/docs
  termsOfService: https://www.twittrapi.com/terms
  license:
    name: 'Proprietary: use under the terms of service'
    url: https://www.twittrapi.com/terms
servers:
- url: https://api.twittrapi.com
  description: Direct API
- url: https://twitter-aio.p.rapidapi.com
  description: RapidAPI (x-rapidapi-key and x-rapidapi-host headers instead of X-API-KEY)
security:
- ApiKeyAuth: []
tags:


# --- truncated at 32 KB (299 KB total) ---
# Full source: https://artifacts.apis.io/twittrapi-com/openapi/twittrapi-com-account-actions-api-openapi.yml