pay per call · no keys · no signup

The X (Twitter) API for AI agents, 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 & pricing

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/Twitter ReadRead 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.0012–$1.20
X/Twitter SearchSearch 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.0012–$1.20
X/Twitter TimelineFetch 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.0012–$1.20
X/Twitter ListsRead 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.0012–$1.20
X/Twitter CommunitiesRead 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.0012–$1.20
X/Twitter Giveaway DrawsRun 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

2 toolsBulk exports to a file, or live events as they land.
X/Twitter Bulk ExportBulk-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.0012–$60.00
X/Twitter MonitorWatch 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

6 toolsPost through a connected account, or draft first.
X/Twitter WriteAct 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 InboxRead 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.0012–$12.00
X/Twitter Profile EditorEdit 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 ManagerManage 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 RadarTrending 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.001
AI Tweet ComposerDraft 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.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

The X/Twitter skill for Claude Code.

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

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

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?

Prices start at $0.001 per call. Single reads cost about $0.0012; volume tools (search, timelines, lists) bill per returned item, and real-time monitors are prepaid at roughly $0.025 per hour. 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 — there is no subscription and no prepaid balance.

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.

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.