# Documentation

- [Error Reference](/docs/error-reference): Every error the GetXAPI Twitter/X API can return, what it means, and when a retry helps. HTTP status codes, X error codes, and per-endpoint handling.
- [Overview](/docs): GetXAPI API documentation. The cheapest Twitter/X API — 57 endpoints from $0.001/call, ~20 results per call. Get started in minutes with code examples.
- [Account Info](/docs/account/account-info): Get your GetXAPI account details, credit balance, and usage summary via API. Free endpoint, 30 requests/min.
- [Payment History](/docs/account/payment-history): Get your GetXAPI payment and top-up history via API. Free endpoint, 30 requests/min.
- [Create Article](/docs/articles/create-article): Create (and optionally publish) long-form Twitter/X articles in one call. $0.01 per call. Premium-only when publishing. GetXAPI article endpoint.
- [Delete Article](/docs/articles/delete-article): Permanently delete a Twitter/X article entity (draft or published). $0.005 per call. GetXAPI article endpoint.
- [Get Article](/docs/articles/get-article): Fetch full Twitter/X article and note content by wrapper tweet ID (public) or by article entity ID (owner-only). $0.001 per call.
- [List Articles](/docs/articles/list-articles): Paginated list of the auth_token user's own Twitter/X articles, filtered by draft or published lifecycle. $0.005 per call.
- [Publish Article](/docs/articles/publish-article): Publish an existing draft Twitter/X article to the timeline. $0.005 per call. Premium-only — the auth_token account must have X Premium.
- [Unpublish Article](/docs/articles/unpublish-article): Move a published Twitter/X article back to draft and remove the wrapper tweet from the timeline. $0.005 per call.
- [Update Article](/docs/articles/update-article): Partial-update an existing Twitter/X article — title, body markdown, or cover image. $0.005 per call. Works on drafts and published articles.
- [Join Community](/docs/community/join-community): Join an X/Twitter community on behalf of an account via API. $0.002 per call. GetXAPI join community endpoint documentation.
- [DM Conversation](/docs/dm/dm-conversation): Fetch the full message history of a single Twitter DM conversation via API, newest first with cursor pagination. $0.001 per call. GetXAPI DM conversation endpoint docs.
- [DM List](/docs/dm/dm-list): List Twitter DM conversations and messages via API across the All, Requests, and Hidden inboxes. $0.002 per call, ~50 per page. GetXAPI DM list endpoint docs.
- [DM Send](/docs/dm/dm-send): Send Twitter direct messages programmatically via API. $0.002 per call. GetXAPI DM send endpoint documentation with code examples.
- [List Members](/docs/lists/list-members): Get all members of a public Twitter/X list via API. $0.001 per call, ~20 users per call. GetXAPI list members endpoint documentation.
- [Upload Media](/docs/media/upload-media): Upload an image, GIF, or video to Twitter/X and get a media_id for tweets via API. $0.001 per call. GetXAPI media upload endpoint.
- [Download Space](/docs/spaces/spaces-download): Download an X/Twitter Space as MP3 with an optional transcript via API. $0.05 base + $0.015 per transcript minute. GetXAPI Spaces download endpoint.
- [Space Info](/docs/spaces/spaces-info): Fetch X/Twitter Space metadata (title, host, state, listener counts) via API. $0.001 per call. GetXAPI Spaces info endpoint documentation.
- [Get Trends](/docs/trends/get-trends): Fetch the current top X/Twitter trends for any country or city via API. $0.001 per call. GetXAPI trends endpoint documentation.
- [Trend Locations](/docs/trends/trend-locations): List every location X/Twitter offers trends for, with WOEIDs, via API. $0.001 per call. GetXAPI trend locations endpoint documentation.
- [Advanced Search](/docs/tweets/advanced-search): Search tweets with advanced operators using GetXAPI. $0.001 per call, ~20 tweets per call — just $0.05 per 1,000 tweets. Twitter API search endpoint with code examples.
- [Bookmark](/docs/tweets/bookmark-tweet): Bookmark a tweet programmatically via API. $0.001 per call. GetXAPI bookmark tweet endpoint documentation with code examples.
- [Create Tweet](/docs/tweets/create-tweet): Post tweets with text, images, and videos via API. $0.002 per call. GetXAPI create tweet endpoint with media upload examples.
- [Delete Tweet](/docs/tweets/delete-tweet): Delete a tweet programmatically via API. $0.001 per call. GetXAPI delete tweet endpoint documentation with examples.
- [Like Tweet](/docs/tweets/favorite-tweet): Like (favorite) a tweet programmatically via API. $0.001 per call. GetXAPI like tweet endpoint documentation with code examples.
- [Retweet Tweet](/docs/tweets/retweet-tweet): Retweet a tweet programmatically via API. $0.001 per call. GetXAPI retweet endpoint documentation with code examples.
- [Tweet Retweeters](/docs/tweets/retweeters): Fetch the list of users who reposted (retweeted) a given Twitter/X tweet. $0.001 per call, ~20 users per page. GetXAPI tweet retweeters endpoint.
- [Tweet Detail](/docs/tweets/tweet-detail): Get a single tweet with full author, media, and engagement data via API. $0.001 per call. GetXAPI tweet detail endpoint with response examples.
- [Tweet Replies](/docs/tweets/tweet-replies): Fetch all replies to a tweet via API. $0.001 per call, ~20 replies per call. GetXAPI tweet replies endpoint documentation.
- [Tweet Thread](/docs/tweets/tweet-thread): Resolve a linear Twitter/X self-thread from any tweet in the thread. $0.005 per call. GetXAPI tweet thread endpoint documentation.
- [UnBookmark](/docs/tweets/unbookmark-tweet): Remove a tweet from your bookmarks programmatically via API. $0.001 per call. GetXAPI unbookmark tweet endpoint documentation.
- [Bookmark Search](/docs/users/bookmark-search): Search inside a user's Twitter bookmarks via API. $0.001 per call, ~20 results per call. GetXAPI bookmark search endpoint documentation.
- [All Bookmarks](/docs/users/bookmarks): List all of a user's Twitter bookmarks via API. $0.001 per call, ~20 results per page. GetXAPI bookmarks endpoint documentation.
- [Check Relationship](/docs/users/check-follow-relationship): Check if one Twitter user follows another via API. $0.001 per call. GetXAPI follow relationship check endpoint documentation.
- [Follow User](/docs/users/follow-user): Follow a user on Twitter/X programmatically via API. $0.001 per call. GetXAPI follow user endpoint with username or user_id targeting.
- [User Followers v2](/docs/users/followers-v2): Get a Twitter user's followers list with ~70 results per page and canDm field. $0.001 per call. GetXAPI followers v2 endpoint docs.
- [Followers You Know](/docs/users/followers-you-know): Get mutual followers between two Twitter accounts via API. $0.001 per call, ~20 users per call. GetXAPI followers you know endpoint.
- [User Followers](/docs/users/followers): Get a Twitter user's followers list with profile details via API. $0.001 per call, ~200 users per call. GetXAPI followers endpoint docs.
- [User Following v2](/docs/users/following-v2): Get accounts a Twitter user is following with ~70 results per page and canDm field. $0.001 per call. GetXAPI following v2 endpoint docs.
- [User Following](/docs/users/following): Get accounts a Twitter user is following via API. $0.001 per call, ~200 users per call. GetXAPI following endpoint documentation.
- [Home Timeline](/docs/users/home-timeline): Fetch your Twitter home timeline feed via API. $0.001 per call, ~20 tweets per call. GetXAPI home timeline endpoint documentation.
- [Unfollow User](/docs/users/unfollow-user): Unfollow a user on Twitter/X programmatically via API. $0.001 per call. GetXAPI unfollow user endpoint with username or user_id targeting.
- [Update Avatar](/docs/users/update-avatar): Update a Twitter user's profile picture programmatically via API. $0.001 per call. GetXAPI update avatar endpoint with image URL or base64 upload.
- [Update Banner](/docs/users/update-banner): Update a Twitter user's profile banner programmatically via API. $0.001 per call. GetXAPI update banner endpoint with image URL or base64 upload.
- [Update Profile](/docs/users/update-profile): Update Twitter profile fields (name, bio, location, URL, color, birthdate) programmatically via API. $0.001 per call. GetXAPI update profile endpoint.
- [User About](/docs/users/user-about): Get Twitter account metadata including creation location and username history via API. $0.001 per call. GetXAPI user about endpoint.
- [User Affiliates](/docs/users/user-affiliates): Get affiliated accounts of a verified Twitter/X organization via API. $0.001 per call, ~20 users per call. GetXAPI affiliates endpoint with pagination.
- [User Info by ID](/docs/users/user-info-by-id): Look up Twitter user profiles by numeric ID via API. $0.001 per call. GetXAPI user info by ID endpoint with response examples.
- [User Info](/docs/users/user-info): Get Twitter user profiles, followers, verified status via API. $0.001 per call. GetXAPI user info endpoint documentation with examples.
- [User Likes](/docs/users/user-likes): Fetch a Twitter user's liked tweets via API. $0.001 per call, ~20 tweets per call — just $0.05 per 1,000 tweets. GetXAPI user likes endpoint.
- [User Login](/docs/users/user-login): Get fresh auth tokens for a Twitter account via API. Required for write endpoints like tweeting and DMs. GetXAPI login endpoint docs.
- [User Media](/docs/users/user-media): Fetch tweets containing images and videos from a Twitter user via API. $0.001 per call, ~20 results per call. GetXAPI user media endpoint.
- [User Mentions](/docs/users/user-mentions): Fetch recent tweets that mention a Twitter user via API. $0.001 per call, ~20 tweets per call — just $0.05 per 1,000 mentions. GetXAPI user mentions endpoint.
- [Search Users](/docs/users/user-search): Search for Twitter/X users by keyword, username, or topic. $0.001 per call, ~20 users per call. GetXAPI user search endpoint with pagination.
- [User Tweets and Replies](/docs/users/user-tweets-and-replies): Fetch tweets and replies posted by a Twitter user via API. $0.001 per call, ~20 results per call. GetXAPI tweets and replies endpoint.
- [User Tweets Complete](/docs/users/user-tweets-complete): Fetch a Twitter/X user's recent tweets-and-replies timeline with self-thread expansion. $0.003 per call, 40 raw results per page. GetXAPI complete tweets endpoint.
- [User Tweets](/docs/users/user-tweets): Fetch all tweets posted by a Twitter user via API. $0.001 per call, ~20 tweets per call — just $0.05 per 1,000 tweets. GetXAPI user tweets endpoint.
- [Verified Followers](/docs/users/verified-followers): Get a user's verified (blue check) followers via API. $0.001 per call, ~20 users per call. GetXAPI verified followers endpoint docs.