{"uid":"cap_nO9JAyr9HUTm2g3mFlCCY","slug":"twitr-sh-x-twitter-data-extractor-6d9b8f26","name":"twitr.sh X/Twitter Data Extractor","description":"Pay-per-call X/Twitter API for AI agents. Read tweets, search, monitor accounts in real time, and post — paid in USDC via x402. No signup, no API keys.","url":"https://twitr.sh/api/tools/x_extract?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"tool":{"enum":["follower_explorer","following_explorer","verified_follower_explorer","post_extractor","reply_extractor","repost_extractor","quote_extractor","thread_extractor","article_extractor","favoriters","mention_extractor","user_likes","user_media","community_extractor","community_moderator_explorer","community_post_extractor","community_search","list_member_extractor","list_post_extractor","list_follower_explorer","space_explorer","people_search","tweet_search_extractor"],"type":"string","description":"Which extractor to run."},"language":{"type":"string"},"minFaves":{"type":"integer"},"mediaType":{"enum":["images","videos","gifs","media"],"type":"string"},"sinceDate":{"type":"string"},"untilDate":{"type":"string"},"searchQuery":{"type":"string"},"resultsLimit":{"type":"integer","maximum":10000,"minimum":1,"description":"MANDATORY: max results extracted, billed per result."},"targetListId":{"type":"string"},"verifiedOnly":{"type":"boolean"},"targetSpaceId":{"type":"string"},"targetTweetId":{"type":"string"},"targetUsername":{"type":"string"},"targetCommunityId":{"type":"string"}}},"responseSchema":{"type":"json","example":{"status":"pending","message":"Extraction accepted — poll status_url until status='ready' to fetch the dataset.","payment":{"amount":"0.600000","currency":"USD","protocol":"x402"},"status_url":"/api/snapshots/sd_ex_a1b2c3d4e5f67890abcdef1234567890","snapshot_id":"sd_ex_a1b2c3d4e5f67890abcdef1234567890"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.024","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.024/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.024","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.024","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_GYtJx74Llux3xr5veed_x","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.024","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Bulk-extracts structured X/Twitter data (followers, tweets, replies, search results, and more) across 23 extractor types, paid per-call in USDC via x402","exampleAgentPrompt":"Pull the last 500 followers of @elonmusk using the follower_explorer extractor, and give me the results once they're ready.","exampleUseCases":[{"title":"Audience research for influencer campaign","prompt":"Extract up to 1000 followers of @naval and give me their profiles — I want to understand who his audience is before pitching a sponsorship."},{"title":"Competitive tweet monitoring","prompt":"Search for all tweets mentioning 'OpenAI' in English since January 1 2025 with at least 100 likes, grab up to 500 results, and compile them for me."},{"title":"Thread archiving for content analysis","prompt":"Extract the full thread from tweet ID 1234567890123456789 — I want to archive the entire conversation including all replies, up to 200 results."}],"resultDescription":"Returns a JSON object with a status of 'pending', a status_url to poll, and a snapshot_id. Once polling returns status='ready', the full dataset is available as structured JSON containing the requested Twitter objects (users, tweets, etc.) up to the specified resultsLimit.","failureModes":["Invalid or suspended target username returns an error","Tweet ID not found or deleted returns empty result","resultsLimit not provided causes request rejection (it is mandatory)","Payment failure via x402 blocks the request","Rate limiting or Twitter-side blocks may cause partial results","Invalid tool enum value returns validation error","Date range conflicts or malformed sinceDate/untilDate cause parsing errors","Community or list IDs that are private/deleted return empty datasets"],"whenToPreferThis":"Use this endpoint when you need bulk or paginated extraction of Twitter data — followers, following, tweets, replies, search results — beyond what single-lookup endpoints provide. It is ideal for large-scale social data collection, audience analysis, competitive monitoring, and archiving. Prefer this over single-record read endpoints when you need more than a handful of results, or when you need one of its 23 specialized extractor types (e.g. community members, list members, space participants). Best suited for async batch workflows since results are returned via a poll-until-ready pattern.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T18:35:26.418Z","isFirstParty":false,"canonicalSlug":"twitr-sh-x-twitter-data-extractor-6d9b8f26"}