pay per call · no keys · no signup

The X API, priced by the call and paid by ClaudeCursorHermesOpenClawyour Claude, Cursor, Hermes, OpenClaw wallet.

$npx agentcash try https://twitr.sh
Browse the toolsRead the docs
14
tools
21
event types
3
networks
$0.001
price floor
Tools

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.

OpenAPI spec

Read & search

6 toolsTweets, profiles, timelines, lists, communities.
X ReadFetch a single tweet, user profile, article, follow relationship, trends, media downloads, or a batch of up to 100 tweets or users.
$0.0012–$1.20
X SearchSearch tweets with the full operator filter set, or search user profiles by keyword.
$0.0012–$1.20
X TimelineUser timelines (tweets, replies, likes, media, mentions), follower graphs, and tweet engagement lists.
$0.0012–$1.20
X ListsRead X list timelines, members, and followers.
$0.0012–$1.20
X CommunitiesCommunity info, members, moderators, tweets, and in-community search.
$0.0012–$1.20
Giveaway DrawsPick crypto-random giveaway winners from a tweet's replies, with retweet/follow/filter conditions.
$0.0024–$84.0012

Export & real-time

2 toolsBulk exports to a file, or live events as they land.
X ExtractBulk extraction jobs (followers, replies, quotes, threads, lists, communities, spaces, people/tweet search) returned as downloadable datasets.
$0.0012–$60.00
X MonitorReal-time monitors on X accounts or keyword queries — prepaid by the hour; events arrive via free polling or your signed webhook.
$0.0264–$4.2348

Write & compose

6 toolsPost through a connected account, or draft first.
X WritePost, reply, like/unlike, retweet/unretweet, follow/unfollow, DM, delete a tweet, remove a follower, or upload media — through an X account you've connected.
$0.006–$0.036
X InboxRead a connected account's private feed — bookmarks, bookmark folders, notifications, and DM history.
$0.0012–$12.00
X ProfileEdit a connected account's profile — display name, bio, location, website, avatar, and banner.
$0.012
X CommunityCreate, join, leave, or delete an X community as a connected account.
$0.012–$0.036
Trend RadarTrending news and topics across regions and categories.
$0.001
Tweet ComposerAI tweet drafting: generate, refine, and score tweet text in a 3-step flow.
$0.001

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.

Why twitr.sh

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.

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.

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 cost
12
write actions
How connecting works
Agent skill

Drop in the playbook, skip the docs.

We publish an installable agent skill — the full workflow for connecting an account, creating monitors, verifying webhook signatures and posting, including the unattended loop that drafts in your voice and queues replies for approval. Point any skill-aware client at it and it knows how to drive twitr.sh end to end.

$curl https://twitr.sh/skill.md
  • /skill.mdthe agent playbook
  • /llms.txtservice index for LLMs
  • /openapi.jsonschemas + payment discovery
  • POST /api/mcptools/list free · tools/call paid

Hook up your agent. Get X data.

14 tools, one spec. Your agent pays, we run it, you get clean JSON.

Get started Read the docs
Submitting to
  • Skills.shSkills.sh
  • PulseMCPPulseMCP
  • GlamaGlama
  • x402scanx402scan
  • Context7Context7

Listings in progress — the agent directories and payment indexes we publish to, not endorsements.