{"uid":"cap_mAo36EErzjxIIFZmy4BRP","slug":"twit-sh-tweet-search-a552307d","name":"twit.sh Tweet Search","description":"Real-time Twitter/X data for AI agents. No sign-up, no API keys. Pay per request in USDC on Base via x402. Fully autonomous.","url":"https://twit.sh/tweets/search?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{"to":{"type":"string","description":"Tweets replying to this username"},"from":{"type":"string","description":"Tweets from this username"},"since":{"type":"string","description":"Start date (YYYY-MM-DD)"},"until":{"type":"string","description":"End date (YYYY-MM-DD)"},"words":{"type":"string","description":"All these words must appear"},"phrase":{"type":"string","description":"Exact phrase match"},"anyWords":{"type":"string","description":"Any of these words"},"hashtags":{"type":"string","description":"Filter by hashtag"},"minLikes":{"type":"string","description":"Minimum like count"},"noneWords":{"type":"string","description":"Exclude these words"},"mentioning":{"type":"string","description":"Tweets mentioning this username"},"minReplies":{"type":"string","description":"Minimum reply count"},"minReposts":{"type":"string","description":"Minimum retweet count"},"next_token":{"type":"string","description":"Pagination cursor"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"data":[{"id":"1110302988","text":"Running bitcoin","author":{"id":"9253672","name":"Hal Finney","username":"halfin"},"created_at":"2009-01-11T03:39:18.000Z","public_metrics":{"like_count":134000,"quote_count":3500,"reply_count":5400,"retweet_count":32000}}],"meta":{"next_token":"abc123"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.006","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.006/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.006","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.006","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_cWRah_KS_5JO88Spr69gq","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.006","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search Twitter/X in real-time by keywords, hashtags, users, date ranges, and engagement filters, paying per request in USDC via x402 with no API keys required.","exampleAgentPrompt":"Search Twitter for tweets mentioning 'bitcoin' that have at least 1000 likes, posted between 2024-01-01 and 2024-06-30, and show me the top results.","exampleUseCases":[{"title":"Brand sentiment monitoring on X","prompt":"Search Twitter for tweets mentioning 'OpenAI' from the past week that have at least 500 likes — I want to see what people are saying about them right now."},{"title":"Tracking a thought leader's posts","prompt":"Pull the latest tweets from @elonmusk posted since 2024-11-01 and show me the ones with the most engagement."},{"title":"Hashtag trend research","prompt":"Find tweets with the hashtag #AIAgents posted between 2024-09-01 and 2024-12-31 that have at least 200 retweets — I'm researching how that topic has evolved."}],"resultDescription":"Returns a JSON array of tweet objects, each containing the tweet ID, full text, author name, username, creation timestamp, and public metrics (like count, retweet count, reply count, quote count). Also includes a next_token for cursor-based pagination to fetch additional pages of results.","failureModes":["No results returned when search filters are too restrictive — try broadening the date range or lowering engagement thresholds","Payment failure if the calling agent's USDC balance on Base is insufficient","Invalid date format (must be YYYY-MM-DD) causes rejected request","Conflicting filters (e.g. both 'words' and 'noneWords' containing the same term) may return empty results","next_token expires or becomes invalid if too much time passes between paginated requests"],"whenToPreferThis":"Choose this endpoint when an AI agent needs to search Twitter/X data in real-time without setting up Twitter developer credentials or managing OAuth tokens. It is ideal for autonomous agents that pay per request in USDC on Base via x402 and need flexible tweet search with rich filters (date range, engagement minimums, hashtags, exact phrases, user scoping). Prefer it over direct Twitter API access when zero setup friction and crypto-native micropayment billing are priorities.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T12:32:46.546Z","isFirstParty":false,"canonicalSlug":"twit-sh-tweet-search-a552307d"}