Real-time, not polling
Monitor an account or keyword and get the post the moment it lands. 21 event types, prepaid by the hour at about $0.025/hr, stops on its own at expiry.
Pay per call · No keys · No signup
The X APIfor AI agents,priced by the call and paid by your Claude, Cursor, Hermes, OpenClaw wallet.
Built for your agent
14 tools. Every call priced up front.
One POST per call. The 402 challenge carries the exact amount and a line-item breakdown before you sign, so an agent always knows the cost first.
Read & search
Tweets, profiles, timelines, lists, communities.
X/Twitter Read
Read live X/Twitter data: look up a single tweet or user profile, batch-read up to 100 tweets or users at once, check whether one account follows another, fetch trending topics by region, extract a long-form article, or download tweet media. Pay per call in USDC — no API key, no signup; failed calls are never charged.
$0.0024–$1.20
X/Twitter Search
Search X/Twitter tweets with the full operator set — keyword, exact phrase, from-user, language, date range, media type, minimum likes/retweets, verified-only — or search user profiles by keyword. Billed per tweet returned against your resultsLimit cap. Built for tracking what people say about a topic, brand, or ticker in real time.
$0.0024–$1.20
X/Twitter Timeline
Fetch a user's X/Twitter timeline — their tweets, replies, likes, media posts, or mentions — plus follower and following lists, and per-tweet engagement lists (who replied, quoted, retweeted, or favorited). Billed per item returned. The building block for monitoring what an account posts or ranking accounts by activity.
$0.0024–$1.20
X/Twitter Lists
Read an X/Twitter List: its combined tweet timeline, its member roster, or its followers. Billed per item returned. Useful for following a curated set of accounts as one feed.
$0.0024–$1.20
X/Twitter Communities
Read an X/Twitter Community: profile info, member and moderator rosters, the community's tweets, or keyword search inside the community. Fixed price for info; billed per item for rosters, tweets, and search.
$0.0024–$1.20
X/Twitter Giveaway Draws
Run a provably fair giveaway on X/Twitter: pick crypto-random winners from a tweet's replies, with retweet, follow, hashtag, keyword, minimum-follower, and account-age conditions. Fixed price set upfront from your estimated entry count.
$0.0024–$84.0012
Export & real-time
Bulk exports to a file, or live events as they land.
X/Twitter Bulk Export
Bulk-export X/Twitter data as downloadable datasets: followers, following, repliers, quoters, reposters, likers, mentions, full threads, list and community members, spaces, or people/tweet search results — 23 extractors. Runs async: you get a claim check immediately and poll a free status URL for the download link. Billed per result.
$0.0024–$60.00
X/Twitter Monitor
Watch an X/Twitter account or keyword query in real time: new tweets, replies, quotes, mentions, hashtags, and profile changes, delivered to your agent by free polling or HMAC-signed webhooks. Prepaid by the hour with a hard stop at expiry — no open-ended billing. The way to track a brand, competitor, or topic without re-polling paid reads.
$0.0264–$4.2348
Write & compose
Post through a connected account, or draft first.
X/Twitter Write
Act on X/Twitter through an account you connect: post a tweet, reply, like, retweet, follow or unfollow, send a DM, delete a tweet, remove a follower, or upload media. Ownership is checked server-side — an agent can only write as a handle its own wallet connected.
$0.006–$0.036
X/Twitter Inbox
Read a connected X/Twitter account's private surfaces: bookmarks and bookmark folders, notifications, and DM history. Billed per item returned; readable only for handles this wallet connected.
$0.0024–$12.00
X/Twitter Profile Editor
Edit a connected X/Twitter account's profile: display name, bio, location, website link, avatar image, and banner image. Acts only on handles this wallet connected.
$0.012
X/Twitter Community Manager
Manage X/Twitter Communities as a connected account: create a new community, join or leave an existing one, or delete a community you own.
$0.012–$0.036
Trend Radar
Trending topics and breaking stories across tech, dev, science, business, culture, politics, and entertainment — aggregated from multiple public sources with regional and time-window filters. Flat sub-cent price per call; the cheap first stop for what is happening right now.
$0.0024
AI Tweet Composer
Draft tweets with AI: generate variants from a topic and goal, refine an existing draft, or score a draft for likely engagement — with tone, call-to-action, and style-matching options. Flat sub-cent price per step.
$0.0024
Dynamic pricing — the exact quote is returned in each 402 before any spend. Volume tools bill per returned item and require resultsLimit, so you never pay for more than you asked for.
Free X tools. No signup.
Check any account for a shadowban, or see whether the X algorithm is working for it. Free in your browser, a few checks a day.
Twitter shadowban checker
Check any X account for a search ban, search suggestion ban, ghost ban, suspension, sensitive-media label and country blocks. Six checks, each with a link to verify it on X.
Free
X algorithm checker
Is the X algorithm working for you? Your last 40 posts scored by Jev on what the For You ranker rewards, plus your reach trend and what to fix first.
Free
Twitter viewer
View any public X (Twitter) profile without an account: bio, follower counts and the latest 20 posts with views, likes, replies and reposts. Free, no login.
Free
Twitter trends
Live X (Twitter) trends for the world and 19 countries: the top topics ranked by X, each linked to its search on X. Refreshed about every hour, no login.
Free
Twitter advanced search
Build any X advanced search in seconds: dates, accounts, exact phrases, minimum likes, language and media. Open it on X, copy it, or run it here without an account.
Free
Twitter follow checker
Does @a follow @b? Check any two X accounts in both directions and spot mutuals. Nobody is notified, no login.
Free
Twitter thread reader
Paste a post link and read the whole X thread as clean, numbered text: the author's posts only, in order, media noted, and one click to copy it all.
Free
Twitter ID finder
Turn any X username or profile link into its permanent numeric user ID, or an ID back into the current handle. Copy it as text or JSON.
Free
Twitter giveaway picker
Pick random, provably fair winners from a post's replies, with repost, follow, keyword, follower and account-age rules. Priced before you run it.
Free
Built for agents that spend their own money.
Watch an account and get the post as it lands, have every event signed and pushed to your endpoint, and post as your own handle without handing over your keys.
Signed webhook delivery
Every event arrives as an HMAC-signed POST with a durable retry ladder over ~36 minutes, auto-pause on repeated failure, and a terminal monitor.expired event.
Your keys stay yours
Connect an X account once, then pay per action across 12 write types. Credentials are relayed sealed — never stored here, never in a URL, never seen by the calling agent.
21 event types~36 min retry window~$0.025/hr monitor cost12 write actions
How connecting works The X/Twitter skill
for Claude Code.
Six installable skills — reads and search, bulk exports, real-time monitors, and posting through an account you connect once, plus the unattended loop that drafts in your voice and queues replies for approval. One command in Claude Code, Cursor, OpenClaw or Hermes, and no X developer account anywhere in the setup.
$
$
Questions agents
(and their humans) ask.
The short version of the docs — what this is, what it costs, and how paying per call works.
What is twitr.sh?
twitr.sh is a pay-per-call X/Twitter API built for AI agents. It covers reads (tweets, profiles, timelines), search with full operator filters, bulk extractions, real-time account and keyword monitors with signed webhooks, and posting through a connected X account. Every request is paid at call time in USDC over the HTTP 402 flow — no signup and no API keys.
How much does the X/Twitter API cost per call?
Reads cost $0.0012 per returned tweet or profile, with a $0.0024 minimum per paid call, so a 20-result search costs about $0.024. Real-time monitors are prepaid at roughly $0.025 per hour, and posting costs $0.036. The exact quote is returned in the 402 challenge before you pay, so an agent always knows the cost first.
How do I use it without an API key?
The wallet is the account. Your first POST to any tool returns HTTP 402 Payment Required with the exact price; your client signs a USDC payment (x402 on Base or Solana, MPP on Tempo) and retries the identical request to get the data. x402-aware clients do both steps automatically.
Which networks and payment protocols are supported?
USDC on three networks: Base and Solana via the x402 protocol, and Tempo via MPP. Both rails settle on-chain per request, with no subscription. If you'd rather pay by card, sign in with Google and top up a balance instead.
Can AI agents use twitr.sh through MCP?
Yes. POST /api/mcp is a streamable-HTTP MCP endpoint: tools/list is free, tools/call is payment-gated with a JSON-RPC 402. There is also an installable agent skill at /skill.md, an LLM service index at /llms.txt, and a full OpenAPI 3.1 spec at /openapi.json.
Does twitr.sh support real-time X/Twitter monitoring?
Yes. A monitor watches one account or one keyword query and emits 21 event types — new posts, replies, quotes, mentions, profile changes, and more. Events are delivered by polling or as HMAC-signed webhooks with a durable retry ladder. Monitors are prepaid by the hour at about $0.025/hr.
Can an agent post to X through twitr.sh?
Yes. Connect an X account once, then pay per action across 12 write types — post, reply, like, retweet, follow, DM, and more. Credentials are relayed sealed during login: never stored, never placed in a URL, never visible to the calling agent.
Am I charged for failed calls?
No. 4xx and 5xx responses are never charged. Resource-creating calls (extractions, monitors, writes) require an Idempotency-Key header, so a retry replays the original result instead of charging twice.
Hook up your agent. Get X data.
14 tools, one spec. Your agent pays, we run it, you get clean JSON.
Submitting toSkills.shPulseMCPGlamax402scanContext7
Listings in progress — the agent directories and payment indexes we publish to, not endorsements.