X (Twitter) data API for AI agents
Posts, profiles, followers, replies, search and lists from X, as data your agent reads in Claude, ChatGPT or Codex. No X developer account and no app to register: a search returns about 21 posts for $0.005, about $0.23 per 1,000 posts against $5 on X's own pay-per-use API.
Read-only. These tools read public X posts, profiles, followers, replies and lists. They never post, comment, like, follow or send a message, and they never sign in to an account of yours: there is no login, cookie or browser extension of yours anywhere in the call.
updated Nov 3, 2026
Copy the setup prompt.
Your agent does the rest.
Connect the superagnt MCP server at https://mcp.superagnt.com/mcp/x to this agent for me (I'll sign in through my browser). The setup guide for each kind of agent is at https://www.superagnt.com/install?facet=x» a new workspace starts with the X (Twitter) tools already on. On an existing workspace, your agent switches them on during setup.
X's official API or this one?
X's API is now pay-per-use with no free tier: $5 per 1,000 post reads and $10 per 1,000 user reads, capped at 3 million post reads a month, with a developer account and app first. This source reads the same public posts for about a twentieth of that, from one key. X's own API wins when you post, or read your own account's data.
| superagnt | X API (pay-per-use) | |
|---|---|---|
| Reading posts | About $0.23 per 1,000 ($0.005 a search, about 21 posts each) | $5 per 1,000 post reads |
| Reading profiles | $0.005 a call | $10 per 1,000 user reads |
| What you need | One key, over MCP or HTTP | A developer account, an app and prepaid credits |
| Monthly cap | None; your plan's requests a minute | 3 million post reads a month |
| Posting | Not offered: read-only | $0.015 a post, $0.20 with a link |
| Your own account's data | Public data only | $0.001 per resource |
| Official MCP server | Yes: mcp.superagnt.com/mcp | Yes, at api.x.com/mcp, with your own X app |
checked Nov 3, 2026 · Pricing (X API docs); Changelog (X API docs)
What can your agent read from X (Twitter)?
Full search by query, language and date range, with floors on likes, replies and reposts, plus posts under a hashtag and a list's timeline, all with continuation paging.
An account's posts with or without replies, plus its media and likes, all continuable.
User details and about data, by username or by user id.
Followers and following, paged, for mapping who an account is connected to.
A single post with its replies, plus who liked it.
Topic classification and language detection over text you pulled, and trends near a location (in beta).
data_x_usersaction: details · about · tweets · media · likes · followers · followingdata_x_postsaction: details · replies · favoritersdata_x_discoveraction: search · hashtag · geo_search · list_details · list_tweets · trends · trend_locationsdata_x_textaction: topics · detect_language
per-operation names47older servers list these
data_x_continuation_user_s_media_get_user_medias_continuationdata_x_continuation_user_s_media_post_user_medias_continuationdata_x_user_s_media_get_user_mediasdata_x_user_s_media_post_user_mediasdata_x_continuation_user_s_likes_get_user_likes_continuationdata_x_continuation_user_s_likes_post_user_likes_continuationdata_x_user_s_likes_get_user_likesdata_x_user_s_likes_post_user_likesdata_x_continuation_user_s_followers_get_user_followers_39ed2926data_x_continuation_user_s_followers_post_user_follower_9aa97da1data_x_user_s_followers_get_user_followersdata_x_user_s_followers_post_user_followersdata_x_user_s_following_continuation_get_user_following_657efcd9data_x_user_s_following_continuation_post_user_followin_13bcf780data_x_user_s_tweets_get_user_tweetsdata_x_user_s_tweets_post_user_tweetsdata_x_user_s_tweets_continuation_get_user_tweets_continuationdata_x_user_s_tweets_continuation_post_user_tweets_continuationdata_x_user_details_get_user_detailsdata_x_user_details_post_user_detailsdata_x_user_about_get_user_aboutdata_x_tweet_replies_continuation_get_tweet_replies_continuationdata_x_tweet_replies_continuation_post_tweet_replies_co_01fc069ddata_x_tweet_user_favoriters_continuation_get_tweet_fav_38b0802adata_x_tweet_details_get_tweet_detailsdata_x_tweet_details_post_tweet_detailsdata_x_tweet_user_favoriters_get_tweet_favoritersdata_x_tweet_replies_get_tweet_repliesdata_x_tweet_replies_post_tweet_repliesdata_x_user_s_following_get_user_followingdata_x_user_s_following_post_user_followingdata_x_lists_tweets_continuation_get_lists_tweets_continuationdata_x_search_continuation_get_search_search_continuationdata_x_search_continuation_post_search_search_continuationdata_x_topic_classification_get_ai_topic_classificationdata_x_detect_post_translate_detectdata_x_available_locations_beta_get_trends_availabledata_x_get_trends_near_a_location_beta_get_trendsdata_x_geo_search_beta_get_search_geodata_x_lists_tweets_get_lists_tweetsdata_x_lists_details_get_lists_detailsdata_x_search_get_search_searchdata_x_search_post_search_searchdata_x_hashtag_get_hashtag_hashtagdata_x_hashtag_post_hashtag_hashtagdata_x_hashtag_continuation_get_hashtag_hashtag_continuationdata_x_hashtag_continuation_post_hashtag_hashtag_continuationWhat does a real call return?
A run we recorded on superagnt, with the result trimmed to fit. Nothing on it is invented: the date, the wall time and the cost are the run's own.
asked Who on X is talking about a CRM migration this week?
- → call
data_x_discover{ "action": "search", "query": "\"crm migration\"", "language": "en", "limit": 20, "response_limit": 4 }← resulttrimmed| created_at | text | likes | views | | Mon Nov 02 15:14:58 +0000 2026 | 10 Reasons Small Businesses Struggle With CRM Migration ... | 1 | 63 | | Tue Nov 03 15:00:40 +0000 2026 | Leaving legacy CRM behind takes more than new software. ... | 9 | 756 | | Tue Nov 03 15:08:04 +0000 2026 | For a CRM migration like Panasonic Avionics', I'd watch ... | 0 | 15 | | Tue Oct 27 14:11:57 +0000 2026 | A successful CRM migration doesn't start with a timeline. ... | 0 | 5 | 4 of 24 posts on this page · next: continuation_token=DAACCgACHWN5uHCA…
the same call over httpcurl · python
curl "https://api.superagnt.com/v1/data/x/search/search?query=%22crm%20migration%22&language=en&limit=20" \
-H "Authorization: Bearer $SUPERAGNT_API_KEY"import os, requests
r = requests.get(
"https://api.superagnt.com/v1/data/x/search/search",
params={"query": "\"crm migration\"", "language": "en", "limit": 20},
headers={"Authorization": f"Bearer {os.environ['SUPERAGNT_API_KEY']}"},
)
print(r.json())» Author handles and the post id column are left out of the transcript; the tool returns them.
What does a search return, and what does it cost per post?
A search returned a median of 21.5 posts, between 12 and 24, across 30 queries: 616 posts in all, with no failed call. At $0.005 a call that is about $0.23 per 1,000 posts. Each post comes with its text, time, author and follower count, likes, reposts, replies, quotes and views.
sample · 30 searches on sales and marketing topics, Nov 3, 2026
Does search return only posts that contain my words?
Mostly, and quotes make it exact. Without quotes, 82% of the 616 posts contained every word of the query and 60% the exact phrase, because search matches loosely. With the phrase in quotes, 190 of 205 posts (93%) contained it. Put the phrase in quotes, and have the agent drop posts that don't contain it before it acts on them.
sample · 30 unquoted and 10 quoted searches, Nov 3, 2026
When is X's own API the better choice?
When you write or read your own data. Posting and replying go through X's API at $0.015 a post, and reading your own account costs $0.001 per resource there. For reading other people's public posts and profiles in bulk, with no developer account, this source costs about a twentieth as much per post.
What do people use it for?
Lead signal from public posts
The agent searches for people describing the problem you solve, keeps the posts that contain the phrase, resolves each author's profile and writes the qualified accounts to the workspace database with the post that triggered them.
Mention triage
A schedule searches your brand and product terms, pulls the replies under anything above a threshold, and asks a person only where a response is warranted.
Competitive narrative tracking
The agent walks competitor timelines, reads the replies underneath, and reports what people push back on and how often it comes up.
What does it cost?
Every call in this source costs the same.
About 600 calls.
Only a call that returns data is billed: a miss, a refusal or an upstream failure costs nothing. One credit balance covers this source and every other one, so there is no per-source subscription and no upstream account of yours to keep alive. After the trial, plans are Starter $49 a month ($20 of data credit included), Growth $149 a month ($90) and Scale $399 a month ($300). Requests per minute: Starter 60, Growth 300 and Scale 600.
What do people ask before they wire it up?
01Do you need to pay to use the Twitter API?
Yes. Since February 2026 X's API is pay-per-use with no free tier: $5 per 1,000 post reads. This source charges $0.005 a search, about $0.23 per 1,000 posts in our test, and the no-card trial covers about 600 searches.
02What can my agent do with this X API?
Read: search posts, hashtags and lists, pull an account's timeline, profile, followers and following, read a post's replies and likes, and classify topics or detect language. It can't post, reply, like or follow.
03How much does the X API cost per post in 2026, and is there still a free tier?
X charges $0.005 per post read and $0.010 per user read, with a 3 million post-read monthly cap, and the free tier is gone for new developers. Here a search returning about 21 posts costs $0.005.
04What is the cheapest way to get tweets?
For bulk reading of public posts, a data API priced per call: here about $0.23 per 1,000 posts, roughly a twentieth of X's per-post price, with no developer account. Put your phrase in quotes so you pay for posts that match.
05Can I publish data I get from X?
It depends on what and where: X's developer terms govern data pulled through its own API, and posts belong to their authors. Quote with attribution and link to the post, and check X's terms for your use. This is not legal advice.
06Is superagnt affiliated with X?
No. superagnt is not affiliated with or endorsed by X Corp. It returns public X data through upstream providers it pays.