superagnt

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.

// data source

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.

works with any agent+ 8 more
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
or follow the detailed setup instructions

» a new workspace starts with the X (Twitter) tools already on. On an existing workspace, your agent switches them on during setup.

01// compared

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.

superagntX API (pay-per-use)
Reading postsAbout $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 needOne key, over MCP or HTTPA developer account, an app and prepaid credits
Monthly capNone; your plan's requests a minute3 million post reads a month
PostingNot offered: read-only$0.015 a post, $0.20 with a link
Your own account's dataPublic data only$0.001 per resource
Official MCP serverYes: mcp.superagnt.com/mcpYes, at api.x.com/mcp, with your own X app
02// what is inside

What can your agent read from X (Twitter)?

Post search

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.

User timeline

An account's posts with or without replies, plus its media and likes, all continuable.

Profiles

User details and about data, by username or by user id.

Social graph

Followers and following, paged, for mapping who an account is connected to.

Post detail and reactions

A single post with its replies, plus who liked it.

Topics, language, trends

Topic classification and language detection over text you pulled, and trends near a location (in beta).

tool names4 tools // 19 actionsas a new server lists them
  • data_x_usersaction: details · about · tweets · media · likes · followers · following
  • data_x_postsaction: details · replies · favoriters
  • data_x_discoveraction: search · hashtag · geo_search · list_details · list_tweets · trends · trend_locations
  • data_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_continuation
03// recorded run

What 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.

recorded runrecorded Nov 3, 2026, 17:27 UTC · wall time 3.0 s · 1 call · 0.5¢

asked Who on X is talking about a CRM migration this week?

  1. → 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
curl "https://api.superagnt.com/v1/data/x/search/search?query=%22crm%20migration%22&language=en&limit=20" \
  -H "Authorization: Bearer $SUPERAGNT_API_KEY"
python
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.

04// measured

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

05// measured

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

06// answered

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.

07// what it gets used for

What do people use it for?

01

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.

02

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.

03

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.

08// cost

What does it cost?

per call
$0.005

Every call in this source costs the same.

per 1,000 calls
$5.00
free trial, no card
$3

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.

09// questions

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.

10// keep going

What else can your agent reach?