Changelog
New updates and improvements to GetXAPI.
July 9, 2026
Trends API is live — top X trends for any location
Fetch the current top X trends for any country or city, ranked by X, with a search URL you can feed straight into Advanced Search. A companion endpoint lists every location trends are available for. $0.001 per call.
- -GET /twitter/trends?country=<name|ISO>&woeid=<id>&count=<n> — top trends for a location (up to 50); defaults to worldwide ($0.001)
- -GET /twitter/trends/locations — list every location (with WOEIDs) trends are available for ($0.001)
- -~530 locations resolvable by name — no need to know WOEIDs
- -Each trend includes a search_url / query to pull tweets via Advanced Search
June 24, 2026
Spaces API is live — metadata, MP3 download + transcripts
Fetch X Space metadata, and download any Space as an MP3 with an optional timestamped transcript. Downloads run async: queue a job, poll for status, then grab signed download URLs. Spaces is a pay-per-use add-on billed from your credit balance (even on subscription plans).
- -GET /twitter/spaces/info?space_url=<url> — Space metadata + audio stream URL ($0.001)
- -POST /twitter/spaces/download — queue an MP3 download, optional transcript; returns a job_id ($0.05 base + $0.015/min transcript)
- -GET /twitter/spaces/download/{job_id} — poll status; returns signed download URLs when done (free)
- -Files are hosted for 7 days, then auto-deleted
June 22, 2026
Join Community endpoint is live
Join an X community on behalf of an account via API. Pass the numeric community ID (from the community URL) and the account's auth_token. Approval-gated communities return a pending/requested state instead of an immediate join. $0.002 per call.
- -POST /twitter/community/join — join a community by its numeric community_id
- -$0.002 per call
- -Approval-gated communities come back as pending rather than joined
- -ct0 and twid are derived automatically from auth_token
June 12, 2026
User Login endpoint patched + repriced
We patched the User Login endpoint for more reliable fresh auth-token retrieval on write-heavy workflows, and out of maintenance mode. Pricing is now $0.01 per call (up from $0.001) to reflect the heavier login flow it runs behind the scenes.
- -POST /twitter/user_login — more reliable token retrieval, back in full service
- -Price updated to $0.01 per call
- -All other endpoints are unchanged ($0.001 standard reads/writes)
June 11, 2026
User Tweets Complete endpoint is live
Fetch a user's recent tweets-and-replies timeline with self-thread expansion, so thread continuations inside the recent window come back more completely than the standard /user/tweets page. $0.003 per call, 40 raw items per page before expansion.
- -GET /twitter/user/tweets/complete?userName=<handle>&cursor=<optional>
- -Expands detected self-threads (capped at 20 roots per page; `complete` flags when the cap is exceeded)
- -$0.003 per call (vs $0.001 for the standard /user/tweets page), priced for the extra thread-expansion work
- -Expanded threads can overlap adjacent pages, dedupe by tweet `id` when paginating with next_cursor
June 11, 2026
Tweet Thread endpoint is live
Resolve a full linear self-thread from any tweet in it, pass any tweet ID and get the ordered thread back, walking only the original author's linked replies. $0.005 per call.
- -GET /twitter/tweet/thread?id=<tweetId>
- -Works from any tweet in the thread, resolves to the root, then walks the author's self-replies in order
- -Pool-based read, no customer auth_token needed
- -Response flags when a very long thread is truncated at the pagination cap
June 10, 2026
Tweet Retweeters endpoint is live
Fetch the full list of users who reposted (retweeted) any tweet. $0.001 per call, ~20 users per page with cursor pagination. Closes the competitor gap with twitterapi.io's get_tweet_retweeter.
- -GET /twitter/tweet/retweeters?id=<tweetId>&cursor=<optional>
- -Pool-based read, no customer auth_token needed
- -Returns tweetId, user_count, has_more, next_cursor, and a users array with full profile data (followers, verified status, bio, location, etc.)
- -Paginate by passing next_cursor until has_more is false
May 31, 2026
Twitter / X MCP Server launched
GetXAPI is now a Model Context Protocol server. Plug the full Twitter/X API into Claude Desktop, Cursor, Cline, or any MCP-compatible client with a one-line install. The MCP server is open source, free to use, and listed on the official mcpservers.org registry. The underlying API calls bill at the standard GetXAPI rate ($0.001 per read, $0.002 per write).
- -Install with a single command: npx -y @getxapi/mcp@latest
- -Drop a 6-line config block into claude_desktop_config.json or the Cursor MCP settings panel, restart the client, and the tools appear automatically
- -Every existing GetXAPI endpoint becomes a native MCP tool: search, tweet/create, dm/list, dm/send, user/info, user/followers, plus the full retweet / favorite / bookmark / delete set
- -Open source on GitHub at github.com/getxapi/getxapi-mcp
- -Published to npm as @getxapi/mcp
- -Listed on mcpservers.org/servers/getxapi/getxapi-mcp
- -Full landing page, code samples, and FAQ at /mcp
May 30, 2026
Delete Tweet endpoint is live
Programmatically delete a tweet owned by the auth_token's account. $0.002 per call. Idempotent, deleting an already-deleted tweet still returns success.
- -POST /twitter/tweet/delete, delete your own tweet by id
- -You can only delete tweets owned by the auth_token's account (others return 403)
- -Idempotent: re-deleting an already-gone tweet returns 200
May 28, 2026
DM endpoints rebuilt, full inbox, 3 tabs, conversation history
DM List now returns your entire inbox (conversations + messages + participant profiles), not just the latest message. We migrated to X's current inbox API, added the All / Requests / Hidden tabs, cursor pagination, and a new endpoint to read a single conversation's full history. $0.002 per call.
- -POST /twitter/dm/list, now returns all conversations with participants (name, avatar, verified), unread state, and a last-message preview
- -`tab` parameter: `all` (main inbox), `requests` (message requests), `hidden` (low-quality/spam)
- -Rich message fields: media (photo/video/GIF), shared tweets, link previews, reactions, replies, edit count
- -Conversation events surfaced (message request accepted, encryption enabled, etc.)
- -POST /twitter/dm/conversation, new: fetch one conversation's full message history with cursor pagination
- -Cursor pagination on every tab via `next_cursor` until `has_more` is false
May 27, 2026
Post to X communities via Create Tweet
POST /twitter/tweet/create now accepts an optional `community_id` to post into an X community. Both short and long-form (Premium) posts are supported, and communities that require moderator review return HTTP 202 with `pending_moderation: true`. Pricing unchanged at $0.002 per call.
- -Pass `community_id` (numeric string), the auth_token's user must already be a member of the community
- -Non-members get HTTP 403 (mapped from X error 440); non-numeric IDs get 400
- -Long-form (>280 char) community posts work on Premium accounts, the underlying mutation is picked automatically
- -Communities with moderator approval return HTTP 202 `pending_moderation: true` until a moderator approves the post, no tweet ID issued yet
- -Response data includes `community_id` echoed back when a post lands in a community
May 20, 2026
Auto-recharge is live
Never run out of credits mid-job. Save a card on file and we'll top up your balance automatically when it drops below a threshold you set. Configure the threshold, recharge amount, and monthly cap from the dashboard.
- -Saved payment method, store a card via Stripe and manage it from the dashboard
- -Threshold trigger, auto-recharge fires when your balance drops below the amount you set (default $5)
- -Recharge amount, choose how much to top up each time (default $10)
- -Monthly cap, recharging pauses automatically once this calendar-month limit is hit (default $40)
- -Powered by your saved card on Stripe, no recurring subscription, only triggered charges when your balance is low
- -Manage or disable any time from the dashboard
May 17, 2026
Article endpoints are live
Seven endpoints for the full lifecycle of long-form X articles, read, draft, publish, update, list, unpublish, and delete. Get Article is $0.001 per call; Create Article is $0.01; Update/List/Publish/Unpublish/Delete are $0.005 each. Publishing requires X Premium on the auth_token account.
- -GET /twitter/article/get, fetch full article/note content by tweet ID ($0.001)
- -POST /twitter/article/create, create a draft (or publish in one call when `publish: true`, Premium-only) ($0.01)
- -POST /twitter/article/update, partial-update title, body markdown, or cover image ($0.005)
- -POST /twitter/article/list, paginated list of your drafts or published articles ($0.005)
- -POST /twitter/article/publish, publish an existing draft, Premium-only ($0.005)
- -POST /twitter/article/unpublish, move a published article back to draft ($0.005)
- -POST /twitter/article/delete, permanently delete an article entity ($0.005)
- -Legacy GET /twitter/tweet/article has been retired, use /twitter/article/get
May 10, 2026
Bookmarks endpoints are live
Three new endpoints to manage and query a user's Twitter bookmarks via API, plus proxy support added to bookmark search. $0.001 per call (~20 results per page where applicable).
- -POST /twitter/user/bookmarks, list all bookmarks for the authenticated user, newest first
- -POST /twitter/tweet/bookmark, bookmark a tweet (idempotent)
- -POST /twitter/tweet/unbookmark, remove a tweet from bookmarks
- -POST /twitter/user/bookmark_search, now accepts an optional `proxy` field
May 6, 2026
Referral program is live
Earn 20% lifetime commission on every payment from anyone you refer. Open to every GetXAPI user, your unique referral link is generated automatically.
- -20% of gross on every payment from referred customers, lifetime
- -$5,000 / calendar year cap per affiliate
- -30-day pending holdback before commission becomes available
- -Convert available earnings to API credits with a +15% bonus
- -Find your link and balance at /dashboard/referrals
April 1, 2026
Account Info & Payment History endpoints
Two new free endpoints to check your GetXAPI account details and payment history. No credits deducted, rate limited to 30 requests per minute.
- -GET /account/me, credit balance, usage summary, account details
- -GET /account/payments, payment/top-up history
- -Free to use, no credits consumed
- -Rate limited: 30 requests/min per API key
March 31, 2026
User Affiliates endpoint is live
Get affiliated accounts of verified organizations (companies, brands, nonprofits). Returns ~20 users per page with cursor pagination. $0.001 per call (~20 tweets).
- -GET /twitter/user/affiliates
- -Returns affiliated accounts of verified organizations
- -Cursor-based pagination (~20 users per page)
- -Includes full profile data for each affiliate
March 27, 2026
Get Article endpoint is live
Fetch full Twitter/X article and note content by tweet ID. Returns rich text blocks, images, author data, and engagement metrics. $0.001 per call.
- -GET /twitter/tweet/article
- -Rich text content with headings, images, blockquotes, and lists
- -Full author profile and engagement stats
- -Supports Twitter Articles and Notes
March 16, 2026
Search Users endpoint is live
Search for Twitter/X users by keyword, username, or topic. Equivalent to the "People" tab in Twitter search. $0.001 per call (~20 tweets).
- -GET /twitter/user/search
- -Search by keyword, username, or topic
- -Returns up to 20 users per page with full profile data
- -Cursor-based pagination support
March 14, 2026
Blog is live
GetXAPI now has a blog. Read guides, tutorials, and comparisons to get the most out of the Twitter API.
- -SEO-optimized blog pages with structured data
- -Syntax-highlighted code snippets with copy button
March 3, 2026
Create Tweet endpoint is live
Post tweets with text, images, and videos via API. Supports media uploads from URLs, base64 data, or pre-uploaded media IDs. $0.002 per call.
- -POST /twitter/tweet/create
- -Attach up to 4 images, 1 GIF, or 1 video per tweet
- -3 media input modes: media_urls, media (base64), media_ids
- -Reply to existing tweets with reply_to_tweet_id
February 22, 2026
Followers v2 & Following v2 endpoints
Two new endpoints. $0.001 per call (~50 tweets).
- -GET /twitter/user/followers_v2
- -GET /twitter/user/following_v2
February 11, 2026
Payment integration is live
You can now purchase API credits directly from the dashboard via Stripe. Two credit packs are available, $10 and $50. No subscriptions, no recurring charges. Credits are added instantly and never expire.
- -Secure one-time payments powered by Stripe
- -$10 Starter pack (~10,000 API calls) and $50 Pro pack (~50,000 API calls)
- -Credits added to your account instantly after payment
- -Payment history visible in your dashboard under Credit History
February 9, 2026
GetXAPI public launch
GetXAPI launched publicly with the cheapest Twitter/X API pricing on the market. $0.001 per call (~20 tweets) for standard endpoints, $0.002 for DM endpoints, and $0.1 in free credits for every new account.
- -29 API endpoints covering tweets, users, search, lists, and DMs
- -Pay-per-call pricing with no subscriptions or monthly fees
- -99.9% uptime SLA with sub-2-second response times
- -Full API documentation at docs.getxapi.com
Next read
Continue exploring GetXAPI: