X (Prev. Twitter) - Full Data API
# X Read & Publish API X Read & Publish API is a developer-friendly X/Twitter API designed for builders who need fast access to social data, profile intelligence, timelines, conversations, communities, lists, trends, hashflags, translations, media uploads, and tweet publishing from a single API surface. Use it to build social listening tools, influencer research dashboards, creator analytics,…
X (Prev. Twitter) - Full Data API endpoints
| Method | Endpoint | Description |
|---|---|---|
| Catalog | ||
| GET |
getEndpointCatalog /api/endpoints |
Returns a machine-readable catalog of all public API endpoints, required parameters, and authentication requirements. |
| Explore | ||
| GET |
search /api/search |
Searches recent X/Twitter posts for a query and returns tweet, user, media, and pagination data. |
| GET |
getTrendLocations /api/locations |
Lists available X trend locations or finds the closest trend locations to latitude and longitude. |
| GET |
autocompleteAlias /api/autocomplete |
Provides the same autocomplete behavior as /api/auto-complete through a shorter alias route. |
| GET |
getTrends /api/trends |
Returns current trending topics for a WOEID, with worldwide trends available by default. |
| GET |
autoComplete /api/auto-complete |
Returns X/Twitter user and topic suggestions for a search query using web or official sources when available. |
| GET |
searchTweets /api/search-tweets |
Searches recent tweets through the official X API v2 using caller-provided X authentication. |
| Tweet | ||
| GET |
getTweetDetailAlternative /api/tweet-detail-alternative |
Retrieves tweet details through the official X API v2 using caller-provided authentication. |
| GET |
getTweetRetweeters /api/tweet-retweeters |
Returns users who retweeted a specific tweet, with optional pagination. |
| GET |
getTweetDetailConversation /api/tweet-detail |
Retrieves tweet details and conversation context from X web data for a given tweet id. |
| GET |
translateTweet /api/translate-tweet |
Translates tweet text by id or direct text into the requested target language. |
| User | ||
| GET |
translateProfile /api/translate-profile |
Translates a profile bio by username, user id, or direct text into the requested target language. |
| GET |
getUserMentions /api/mentions |
Returns recent mentions for a user through the official X API with pagination. |
| GET |
getUserAffiliates /api/user-affiliates |
Extracts affiliate and highlighted-label information from a user's public profile data. |
| GET |
getUserByScreenName /api/user-by-screen-name |
Retrieves a user's public profile by screen name or username. |
| GET |
getUserFollowerIds /api/user-followers-ids |
Returns follower user ids for a screen name or user id through OAuth-authenticated X API v1.1. |
| GET |
getUserSubscriptions /api/user-subscriptions |
Returns a user's public subscriptions surface when available from X web data. |
| GET |
getUserTweets /api/user-tweets |
Returns a user's recent posts with optional pagination and media expansions. |
| GET |
getUserByRestId /api/user-by-rest-id |
Retrieves a user's public profile by numeric rest id. |
| GET |
getUserVerifiedFollowers /api/user-verified-followers |
Returns verified followers for a user by filtering follower data where available. |
| GET |
getUsers /api/users |
Looks up multiple users by numeric ids or usernames and returns profile data. |
| GET |
getUserMedia /api/user-media |
Returns a user's media timeline, including posts with images, video, or other media. |
| GET |
getUserAbout /api/user-about |
Retrieves richer public profile and about data for a user by username or id. |
| GET |
getUserFollowers /api/user-followers |
Returns followers for a user through the official X API with pagination support. |
| GET |
getUserFollowersLight /api/user-followers-light |
Returns a lighter follower list optimized for compact user profile data. |
| GET |
getUserFollowingLight /api/user-following-light |
Returns a lighter following list optimized for compact user profile data. |
| GET |
getUserFollowing /api/user-following |
Returns accounts followed by a user through the official X API with pagination. |
| GET |
getUserHighlights /api/user-highlights |
Returns highlighted posts for a user when available from X web data. |
| GET |
getUserTweetsAndReplies /api/user-tweets-replies |
Returns a user's recent posts and replies with optional pagination. |
| GET |
getUsersByRestIds /api/users-by-rest-ids |
Looks up multiple users by numeric rest ids and returns matching profiles. |
| GET |
getUserFollowingIds /api/user-following-ids |
Returns following user ids for a screen name or user id through OAuth-authenticated X API v1.1. |
| List | ||
| GET |
getListTimeline /api/list-timeline |
Returns tweets from an X List timeline with optional pagination. |
| GET |
getListDetails /api/list-details |
Returns metadata and owner information for an X List. |
| GET |
getListSubscribers /api/list-subscribers |
Returns users subscribed to an X List with optional pagination. |
| GET |
getListMembers /api/list-members |
Returns members of an X List with optional pagination. |
| Community | ||
| GET |
getCommunityModerators /api/community-moderators |
Returns moderators and related about data for an X Community. |
| GET |
getCommunityDetails /api/community-details |
Returns public metadata and details for an X Community. |
| GET |
searchCommunityMembers /api/community-member-search |
Searches members inside a specific X Community by query. |
| GET |
getCommunityMembers /api/community-members |
Returns members of an X Community with optional pagination. |
| Misc | ||
| GET |
getHashflags /api/hashflags |
Returns active hashflags and optionally filters them by hashtag. |
| Publish | ||
| POST |
postBasicGamezonehubTweet /api/tweet_basic_gamezonehub |
Publishes a basic text tweet using the same caller-provided OAuth credential headers. |
| POST |
postBasicTweet /api/tweet_basic |
Publishes a text tweet and optionally uploads media from an image URL before posting. |
| POST |
uploadVideo /api/video |
Uploads a base64 or URL-sourced video to X using direct or chunked media upload. |
| POST |
postThread /api/thread |
Publishes a multi-tweet thread sequentially, with optional delay, media, and quote-hook behavior. |
| POST |
postTweet /api/tweet |
Publishes a tweet with optional media ids using caller-provided OAuth credentials. |
| POST |
postTweetReplyNoImage /api/tweet_reply_noImage |
Publishes a text-only reply to an existing tweet. |
| POST |
postTweetReply /api/tweet_reply |
Publishes a reply tweet with optional media using caller-provided OAuth credentials. |
| POST |
postTweetQuote /api/tweet_quote |
Publishes a quote tweet or reply with caller-provided OAuth credentials. |
| POST |
uploadImage /api/image |
Uploads a base64-encoded image to X and returns media identifiers for later tweet publishing. |
X (Prev. Twitter) - Full Data API pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | — |
|
| PRO Recommended | $25 / month | 10 / second |
|
| ULTRA | $75 / month | 30 / second |
|
| MEGA | $150 / month | 60 / second |
|