New
- Pick what an API key can call on the API keys page. Add write, monitors, exports or billing to a read key
-
Calls outside a key’s scopes get
403 insufficient_scope, REST & MCP alike.requiredScopenames the scope to add -
POST /api-keys&PATCH /api-keys/{id}takescopes, & every key carries it. Full access keys work as before - Lock an API key to your IPs on the API keys page. It takes up to 20 IPs or CIDR ranges. An empty list allows any IP
-
Calls from other IPs get
403 ip_not_allowed, REST & MCP alike. The message names the calling IP -
POST /api-keys&PATCH /api-keys/{id}takeallowedIps, & every key carries it. Keys without a list work as before - Pause an API key on the API keys page & resume it later. Select several keys to pause or resume them together
-
A paused key gets
403 api_key_pausedon every API route & the MCP server. Pausing keeps the key & its settings -
PATCH /api-keys/{id}takespaused, & a paused key carriespausedAt. Keys you never pause work as before -
PATCH /api-keyspauses or resumes up to 100 keys in 1 request -
API keys take an optional monthly credit budget,
monthlyBudgetCredits, on create & update -
Each key shows
monthlySpentCredits, its spend this UTC calendar month. The owner gets 1 email at 80% -
At its budget, new REST, MCP & Actor calls with the key get
403 api_key_budget_reached - The key works again next UTC month, or once the owner raises its budget
-
GET /x/sports/{league}/games/{id}/rosterreturns both teams’ players with jersey, position, headshot & X account -
GET /x/sports/{league}/games/{id}/player-propsreturns the prop lines & American odds X shows for an NFL game -
Each costs 1 credit, &
ncaafbgets a freeunsupported_league. MCP adds them asgetFootballRoster&getFootballPlayerProps, and guest keys can call them -
A football player’s
xUsernow carriesprotected,superFollowEligible&labelType, which rosters fill -
GET /x/sports/{league}/games/{id}/postslists a game’s top or latest posts. It also gives the X (Twitter) search that finds them -
It costs 1 credit per post, & a game X does not know is free. MCP adds it as
getSportsGamePosts, and guest keys can call it -
GET /x/sports/{league}/games/{id}/audiencereturns a game’s live viewers, fan picks per team, chat state & teams. It costs 1 credit, & a game X does not know is free. MCP adds it asgetSportsGameAudience -
GET /x/sports/{league}/gameslists NFL or college football games in a time window. Each game carries its game & team IDs -
GET /x/sports/{league}/games/{id}returns a game’s scoreboard. Its/playsroute returns every drive & play. Its/box-scoreroute returns team totals & player stats -
Each costs 1 credit, & a game X does not know is free. MCP adds them as
listFootballGames,getFootballScoreboard,getFootballPlays&getFootballBoxScore, and guest keys can call them -
OpenAPI declares the
Deprecation,Link&Sunsetheaders on each answer that sends them - The versioning & deprecation policy lists today’s deprecated items, their dates & the 90-day notice
-
Profiles carry
redirectsToUsername, the handle x.com redirects the profile to. A renamed account’s new handle is one example -
GET /x/news/{id}/versionsreturns every version X wrote of a news story from Explore, oldest first -
Each version has its time, headline & text. It costs 1 credit per request, & a story X does not know is free. MCP adds it as
getXNewsStoryVersions, and guest keys can call it -
GET /x/spaces/searchtakesqueryType=Live&queryType=Upcoming, which list Spaces on air now or scheduled. Both match words in Space titles -
Each row is the full Space
GET /x/spaces/{id}returns, for 1 credit -
GET /x/community-notes/contributors/{alias}answers a Community Notes contributor’s note counts by rating & rating counts -
Its
/notesroute lists every note they wrote with its post. That includes the notes x.com hides. Its/deleted-notesroute lists the notes they deleted -
The lookup costs 1 credit & each note costs 1 credit. An unknown alias is free. MCP adds them as
getCommunityNotesContributor,listCommunityNotesContributorNotes&listCommunityNotesContributorDeletedNotes, and guest keys can call them -
GET /x/trends/historyreads Xquik’s Twitter trends archive. The archive holds the lists X showed for a place over a time range -
It returns 1 stored list per step, each with its own
capturedAt. Stored lists start at 2026-10-13 02:20 UTC. Each list costs 1 credit, up to 100 per request -
GET /x/trendstakesat& answers with the stored list nearest that time, for 1 credit. MCP adds the range asgetXTrendsHistory, and guest keys can call it -
at,from&toalso take a span back from now, like24hor7d. With a span, a schedule reads yesterday’s trends on every run -
A range answer names the times it read in
fromTime&toTime. Itsnext_cursorkeeps every page on the first request’s time -
POST /webhooks/telegramgives a t.me link to @XquikBot. The link connects a Telegram chat to your monitors - Press Start & each event arrives as a message. Retries, deliveries & resume work as for webhooks. It’s free
-
GET /events/streamsends your monitor events live over 1 connection, as server-sent events -
Reconnect with
Last-Event-IDto replay what you missed from the last 30 days. Streaming is free -
GET /x/users/{id}/insightsanswers a profile’s engagement rate, averages per post, posting rate & top post -
GET /x/tweets/{id}/insightsanswers a tweet’s engagements per hour, per view & per follower of its author -
Each report costs 1 credit, & a profile or tweet X doesn’t know is free. MCP adds them as
getUserInsights&getTweetInsights, and guest keys can call them -
GET /x/tweets/toplists the tweets X ranks highest. X ranks them by likes, replies, quotes, bookmarks, shares or views -
Pick a day, week or month, & all of X, a country or a language. Each tweet costs 1 credit, up to 100 per list. MCP adds it as
getTopTweets, and guest keys can call it -
GET /x/users/{id}/livesays whether a user is broadcasting live on X now. It also returns their latest broadcast -
It costs 1 credit per check, & a user X does not know is free. MCP adds it as
getUserLiveStatus, and guest keys can call it -
GET /x/tweets/{id}/replieswithmode=completetakesincludeHidden=trueand adds the replies the post’s author hid -
Each has
hiddenByAuthor: trueand costs 1 credit like any reply. A post without hidden replies costs nothing extra -
GET /x/users/{id}/translationreturns X’s own translation of a profile’s bio into the language you pick -
It costs 1 credit per translation, & a profile without a bio is free. MCP adds it as
translateUserBio, and guest keys can call it -
GET /x/tweets/{id}/repliesno longer answers 503 when X counts replies it shows nobody. It ends the list instead -
The last page names them in
hiddenReplies, & it costs nothing extra -
GET /x/tweets/{id}/retweeter-idsreturns the user IDs of a post’s reposters. It keeps the order & pages ofGET /x/tweets/{id}/retweeters -
Each ID costs 1 credit, & a post nobody reposted is free. MCP adds it as
getTweetRetweeterIds, and guest keys can call it -
GET /x/communities/{id}/members/searchfinds a Community’s members by name or username, each with its role -
It costs 1 credit per member, & an answer without members is free. MCP adds it as
searchCommunityMembers, and guest keys can call it -
Posts in a Community add
communityNamebesidecommunityIdwhen X sends the name. It costs nothing extra -
The 6 analysis endpoints take
baseline, the rows of an earlier answer. Each result’smonitorsays whether the post is new, changed or unchanged. The comparison costs nothing extra -
Score answers, such as
intensityorconviction, can have decimals between levels - 6 AI analysis endpoints read X posts, searches or your own texts. Each analyzed post costs 2 credits
-
POST /x/analysis/sentimentanswers each post’s attitude, its intensity & its sarcasm probability -
POST /x/analysis/brandanswers each post’s relevance, attitude & customer relationship for your brand -
POST /x/analysis/newsanswers each post’s format, source attribution & relevance to your topic -
POST /x/analysis/market-signalsanswers each post’s stance on an asset & counts bullish & bearish posts per cashtag -
POST /x/analysis/viral-scorerates how viral a post or draft reads, from 0 to 100. Each score comes with a verdict -
POST /x/analysis/classifyanswers up to 8 questions you write, as categories, scores or yes/no -
A search can name an account in
usernameor a List inlistId. Or it can name a post inquotesOforrepliesTo. It reads posts betweensinceTime&untilTime - A post without an analysis costs nothing. MCP lists all 6, and guest keys can call them
-
GET /x/articles/{tweetId}addsbodyMarkdown, the Article body as Markdown - It keeps headings, lists, bold, italic, links & images, without HTML. It costs nothing extra
-
Search rows add
textHighlights, which mark where the row’stextmatches the search -
Each range has
startIndex&endIndex, counted in code points oftext. It costs nothing extra -
GET /x/users/batch/tweetsreturns the newest posts of up to 20 users in 1 call -
Name the users by
idsorusernames. It costs 1 credit per post -
A user it could not read is named in
unprocessed_ids& costs nothing -
MCP adds it as
getBatchUserTweets, and guest keys can call it -
GET /x/communities/findfinds X Communities by keyword. It costs 1 credit per Community -
GET /x/communities/popularlists the most popular Communities of a topic or subtopic -
Send the topic by
topicIdor by name astopic. It costs 1 credit per Community -
GET /x/communities/topicslists every Community topic & subtopic, 1 credit per topic -
GET /x/communities/suggestedlists the Communities X (Twitter) suggests to join, 1 credit each -
GET /x/communities/{id}/mediareturns a Community’s Media tab, 1 credit per post -
GET /x/communities/{id}/tweetstakesqueryType=Topfor the Community’s Top posts -
Community responses add
banner, with its size, main colors & focus area -
MCP adds
findCommunities,getPopularCommunities,getCommunityTopics,getSuggestedCommunities&getCommunityMedia, and guest keys can call them -
Community find & popular answer a free 400
invalid_cursorwhen X refuses a cursor -
GET /x/tweets/{id}/retweeters/checksays whether 1 account reposted a post - It reads the account’s newest posts. Each check costs 1 credit
-
MCP adds it as
getTweetRepostCheck, and guest keys can call it -
GET /x/users/{id}/affiliatesreturns the accounts an organization lists as its affiliates, in X’s order - Each row is a full profile. It costs 1 credit per result
-
MCP adds it as
getUserAffiliates, and guest keys can call it -
GET /x/users/{id}/subscriptionsreturns the creators a user subscribes to, in X’s order - Each row is a full profile. It costs 1 credit per result
-
MCP adds it as
getUserSubscriptions, and guest keys can call it -
GET /x/users/{id}/follower-idsandGET /x/users/{id}/following-idsreturn user IDs only - A page holds up to 5,000 IDs, newest first. Each ID costs 1 credit
-
MCP adds them as
getUserFollowerIdsandgetUserFollowingIds, and guest keys can call them -
GET /x/tweets/{id}/hidden-repliesreturns the replies a post’s author hid, oldest first - It lists replies to hidden replies too. It costs 1 credit per reply
-
MCP adds it as
getTweetHiddenReplies, and guest keys can call it -
GET /x/tweets/{id}/translationreturns X’s own translation of a tweet into the language you pick - It returns the detected source language and the links of the translated text. It costs 1 credit per call
-
MCP adds it as
translateTweet. Guest keys and direct MPP can call it -
GET /x/tweets/{id}/embedreturns the HTML that embeds a tweet on a website. It comes in a light or dark theme - It can hide media and the thread, and leave the widget script out. It costs 1 credit per call
-
MCP adds it as
getTweetEmbed. Guest keys and direct MPP can call it -
GET /x/links/resolvereturns where up to 100 t.co links lead, in the order sent -
It costs 1 credit per resolved link. A link X does not answer for comes back in
unprocessedUrls, free -
MCP adds it as
resolveLinks, and guest keys can call it -
GET /x/tweetstakes tweet URLs beside tweet IDs inids. It reads a tweet named twice once -
GET /x/followers/checktakes user IDs beside usernames, and returnssourceId&targetId -
GET /x/tweets/{id}/subtitlesreturns the caption tracks of a tweet’s videos. Each track has timed cues & the full text - It costs 1 credit when a track comes back. A tweet without captions costs nothing
-
MCP adds it as
getTweetSubtitles, and guest keys can call it -
GET /x/users/{id}/similarlists the accounts X (Twitter) shows as similar, in X’s order -
It costs 1 credit per account. MCP adds it as
getSimilarUsers, and guest keys can call it - Results can differ between calls. Xquik now returns a fuller, steadier list
-
GET /x/users/{id}/articleslists the X Articles a profile published, newest first - Each row is the Article’s post with its title, preview & cover. It costs 1 credit per post
-
MCP adds it as
getUserArticles, and guest keys can call it -
GET /x/users/{id}/highlightsreturns the posts on a profile’s Highlights tab - Rows keep X’s order. It costs 1 credit per post returned
-
MCP adds it as
getUserHighlights, and guest keys can call it -
GET /x/trends/locationslists the places X offers trends for -
Each location has its
woeid, country, country code & place type -
country,placeType,q&limitfilter the list. It costs 1 credit per location -
MCP adds it as
getXTrendLocations -
GET /x/search/autocompletereturns the accounts, topics, hashtags & cashtags X suggests for a query -
typeskeeps only the kinds you choose.limitcaps the suggestions - Cashtags carry price, market cap & 24-hour change. It costs 1 credit per suggestion
-
MCP adds it as
autocompleteSearch -
GET /x/lists/searchfinds public Lists by keyword, at 1 credit per List - Each List has its counts, banner & owner profile. Private Lists stay out
-
MCP adds it as
searchLists, and the SDKs aslists.retrieve_search -
GET /x/users/{id}/listsreturns the public Lists an account created, in X’s order -
GET /x/users/{id}/list-membershipsreturns the public Lists that include an account -
Each List costs 1 credit. MCP adds them as
getUserLists&getUserListMemberships -
GET /x/spaces/searchfinds public Spaces by keyword, host or topic, at 1 credit per Space -
It returns live, scheduled & ended Spaces, each once per page. MCP adds it as
searchSpaces -
Space search takes
pageSize, the most Spaces a page returns. It runs from 1 to 100 and defaults to 20 -
GET /x/spaces/{id}returns 1 Space with its state, times, listener counts, hosts & speakers -
It takes a Space ID or URL & costs 1 credit per call. MCP adds it as
getSpace -
GET /x/spaces/{id}/replayreturns an ended Space’s recording as an HLS playback URL -
A live or scheduled Space answers 409. It costs 1 credit per call. MCP adds it as
getSpaceReplay -
A Space & each Space search row add
sharings, the posts shared in the Space - Each sharing has the post, the account that shared it & when
-
A Space cancelled before it started answers 404
space_canceledon its replay -
GET /x/broadcasts/{id}returns 1 X live video with its title, state, times & watch counts -
It takes a broadcast ID or URL & costs 1 credit per call. MCP adds it as
getBroadcast - Guest keys & direct MPP can call it. Reading a broadcast adds no view to it
-
A broadcast adds
tweetId&tweet, the post that announces it -
A Space & each Space search row add
tweetbesidetweetId -
Job search answers a free 400
invalid_cursorwhen X refuses a cursor -
GET /x/tweets/{id}/retweetersanswers the same free 400invalid_cursor -
GET /x/jobs/searchsearches public X job listings by keyword - Filter by location, work type, seniority, employment type & company
- Each job returned costs 1 credit. A closed job is left out & free
-
GET /x/jobs/{id}returns 1 job with its description as text & Markdown -
GET /x/jobs/locationsfinds places & the location ID job search takes -
MCP adds
searchJobs,getJob&getJobLocations, and guest keys can call them -
GET /x/places/searchfinds X places by name, at 1 credit per place -
Each place has the
idthat tweet search takes asplace -
GET /x/hashflagslists the custom emoji X shows after hashtags, at 1 credit each -
q&activeOnlyfilter the hashflags. Each has its image & the time it runs -
MCP adds them as
searchXPlaces&getXHashflags, and guest keys can call both
-
Each webhook delivery gets 7 days. One still failing after that ends
exhausted -
lastErrorsays why. A delivery that never got a try showsWebhook paused,Monitor pausedorEndpoint failing - A paused webhook or monitor holds its deliveries for those 7 days. Resume before a delivery’s 7 days end to receive it
-
An
exhausteddelivery’s event stays 30 days after it ends. Read it withGET /events/{id} -
X can refuse a reply to a post deleted or hidden from your account. That call returns
422 x_reply_target_unavailableinstead ofx_target_not_found -
Xquik charges nothing. That account’s later replies to the post get the same error.
Retry-Aftersays when to try again -
An MCP answer over 24,000 characters returns its first page, not a
response_too_largeerror. It carriescharacters,next_offset,next&text, plusresult_idwhen the answer is saved - An MCP answer too large to keep also returns no error. It returns its size, its saved reads & the next step
-
Connecting, re-authenticating, retrying & disconnecting X accounts now needs a signed-in dashboard session. API keys & OAuth tokens get
403 session_required, so a leaked key never reaches X passwords -
The 6 routes are
POST /x/accounts,GET /x/account-connection-attempts/{id},POST /x/account-connection-challenges/{id}/submit,POST /x/accounts/{id}/reauth,POST /x/accounts/bulk-retry&DELETE /x/accounts/{id}. MCP no longer lists them -
GET /x/accounts&GET /x/accounts/{id}still take an API key -
For an account with a plan,
POST /subscribegives the dashboard billing page. The user signs in there to manage billing. It used to give a billing portal session -
API key management & saved-card top-ups answer an API key with
403 session_required. The answer names the dashboard. This replaces a same-origin error -
POST /webhooks/telegramwithouteventTypesnow connects new posts only. Connected chats keep their event types - Telegram alerts in a burst arrive as 1 digest every few seconds. Only the first message of a minute rings
- A busy Telegram chat now gets 5 quick messages, then 1 every 30 s. That keeps it inside Telegram’s limits. A quiet chat still gets each alert at once
- Discord & Slack channels get the events of 1 post as 1 alert. Alerts that wait together come as 1 message. Their pace matches a Telegram chat’s
- Telegram, Discord & Slack alerts name events as the dashboard does, such as “New post”. A profile change reads as a sentence
- A resumed monitor starts from the moment it resumes. Posts made during the pause send no event & stay readable with tweet search
- A new keyword monitor no longer sends an older post as its first event
-
mode=completeonGET /x/tweets/{id}/repliesanswers 200 when X shows none of a post’s counted replies -
The answer names them in
hiddenRepliesinstead of424 replies_incomplete, & it costs nothing - Active monitors cost 30 credits per hour, up from 21. Creating one needs 30 available credits & charges no lookup credit
- Top tweet search skips posts that can’t match your query
-
Skipped posts count in
filtered_count& cost nothing -
GET /x/tweets/{id}/repliespages can be empty & still report more -
Such a list used to end there, without the replies its next pages hold. Follow
next_cursorwhilehas_next_pageistrue -
Tweet search extractions answer 424
search_unavailablefor a filter X (Twitter) search dropped. They charge nothing -
The filters are
source,geocode,within&news: true -
In a query they are
source:,geocode:,within:,retweets_of:,filter:vine,filter:consumer_video,filter:pro_video&filter:news -
POST /extractions, its dry run &POST /extractions/estimateanswer before any job starts. The message names the filter to remove - Such an extraction used to end without rows
-
excludeSource,-source:&-within:keep working until 2027-01-15. X ignores them, so the extraction returns unfiltered rows -
Until then those answers carry
Deprecation&Sunsetheaders. From 2027-01-15 they answer 424 too -
GET /x/followers/checkcosts 1 credit per check, down from 5. Direct MPP charges USD 0.00015 per call. A draw’smustFollowUsernamecheck costs 1 credit -
descriptionMarkdownonGET /x/jobs/{id}numbers ordered lists 1, 2, 3 and keeps line breaks -
It escapes characters that would read as Markdown or HTML. These include
[,*&< -
GET /x/communities/{id}/tweetsopens its first page with the pinned post, flaggedisPinned -
An empty
GET /x/communities/suggestedanswer means X suggests none right now. It stays free -
GET /x/trendstakes acountryor alocationname, such aslocation=Istanbul -
The response returns the place it read as
location.woeidstill wins -
A write’s
402addstop_up_url&dashboard, which say where to add credits -
404 user_not_foundaddsreason, which isnot_foundorsuspended - A suspended account answers “X (Twitter) suspended this account. Choose another account.”
-
Account responses add
connectedAt, when the account last connected or reconnected -
X-Xquik-Busy-Reasonis nowadmissionorreads -
GET /x/users/batchtakesusernamesin place ofids, with or without@ - Send up to 100 usernames. The ID lists then name the usernames as sent
-
usernamesalso takes profile links, such asx.com/nasa. A link is named by its username -
The text
undefinedornullinusernamesnow answers 400 & costs nothing -
A filtered
LatestTweet search addsreadBackTo, how far back it has read - 7 account lists now page with a cursor. They no longer stop at 100 or 200 rows
- They are monitors, keyword monitors, webhooks, webhook deliveries, API keys, styles & support tickets
-
Each takes
limit&cursor, and answershasMore&nextCursor - A 1st page keeps its size & order, so existing clients see the same rows
- Xquik keeps queued events until all deliveries finish
- Events expire 30 days after Xquik creates them
-
GET /creditsaddsauto_topup_stopped&GET /accountaddscreditInfo.autoTopupStopped -
truemeans 3 declined charges in a row on one card stopped automatic top-up - An event keeps the monitor label from when Xquik created it
- Renaming a monitor no longer changes past events or their retries
- Each retry of a webhook delivery sends its first attempt’s exact body
-
Tweet & DM
textnow reads as x.com shows it -
X’s
&,<&>arrive as&,<&> -
displayTextRange& entityindicescount the decoded text - A repost row now shows its original post’s counts
- That covers likes, replies, reposts, quotes, bookmarks & views
-
Tweet search reads
since:,until:,sinceDate&untilDateas UTC days - x.com uses your time zone, so its day edges can differ
-
untilDateis inclusive, sountilDate=2026-03-01returns that day’s posts too - Followers come newest first
-
A reply request with
sinceTime&scope=directends once it covers your window - Such a request ends sooner
-
A write retried with the same
Idempotency-Keyreturns the first answer again -
It keeps the first status, body &
Retry-After, withidempotent: trueadded -
A rejected post’s retry now answers
422like the first answer, not200