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. No signup, no API keys — every request is paid in USDC through the HTTP 402 flow, and the exact price is quoted before you pay.
One endpoint: POST /api/tools/x_extract over HTTP, or the x_extract tool over MCP at POST /api/mcp.
curl -X POST https://twitr.sh/api/tools/x_extract \
-H 'Content-Type: application/json' \
-d '{"tool":"follower_explorer","targetUsername":"elonmusk","resultsLimit":500}'
# → 402 Payment Required with the exact USDC price.
# Pay it (x402 on Base/Solana, MPP on Tempo) and retry the same request → 200 + data.
# x402-aware clients do both steps automatically.tool selects the extractor (23 options). Provide the matching target: targetTweetId (reply/repost/quote/thread/article/favoriters extractors), targetUsername (follower/following/verified/post/mention/likes/media), targetCommunityId, targetListId, targetSpaceId, or searchQuery (people_search, tweet_search_extractor). resultsLimit is MANDATORY — billed per result (article_extractor bills 5× per result). Runs ASYNC: the response is a claim check {snapshot_id, status_url}; poll status_url (free, SIWX) until status=ready for the download link. Idempotency-Key header is required so retries reuse the same job.
Bills per returned row — resultsLimit is required, so you never pay for more than you asked for. Extractions run async: the call returns a snapshot id and the paying wallet fetches the dataset for free. Full input schema in the OpenAPI spec.
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. It is one of 14 pay-per-call X/Twitter tools on twitr.sh, available over HTTP (POST /api/tools/x_extract) and MCP (tool name x_extract).
$0.0012–$60.00 per call in USDC. Bills per returned row — resultsLimit is required, so you never pay for more than you asked for. Extractions run async: the call returns a snapshot id and the paying wallet fetches the dataset for free.
POST https://twitr.sh/api/tools/x_extract with your input. The first response is HTTP 402 Payment Required carrying the exact price; pay it in USDC (x402 on Base or Solana, MPP on Tempo) and retry the identical request to get the data. No signup — the wallet is the account.
Yes. Call the x_extract tool via the MCP endpoint at POST https://twitr.sh/api/mcp — tools/list is free, tools/call is payment-gated with a JSON-RPC 402. The installable agent skill at https://twitr.sh/skill.md covers the full workflow.