{"uid":"cap_I0XO1_7Xrex214nRQo0p5","slug":"x402-twit-sh-35962144","name":"x402.twit.sh Tweet Search","description":"Search Twitter/X tweets with advanced filters. Returns up to 20 tweets per page, most recent first, with pagination. At least one filter required. Params: words, phrase, anyWords, noneWords, hashtags, from, to, mentioning, minReplies, minLikes, minReposts, since (YYYY-MM-DD), until, next_token. e.g. GET /tweets/search?words=bitcoin&from=elonmusk&minLikes=100. Returns X v2 API-compatible JSON.","url":"https://x402.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":{"request":{"input":{"type":"http","method":"GET","queryParams":{"since":"2024-01-01","until":"2024-12-31","words":"artificial intelligence","minLikes":"10"}}},"response":{"_truncated":true,"_originalSize":96996}},"exampleRequest":{"since":"2024-01-01","until":"2024-12-31","words":"artificial intelligence","minLikes":"10"},"tags":["x402"],"displayCostAmount":"0.006","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":2,"rating":{"score":"0.96","successRate":"1.00","reviews":2,"stars":"4.8","state":"rated"},"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_LGA_haD4uLxwclqyLhqdb","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 tweets with advanced filters including keywords, phrases, hashtags, user filters, engagement thresholds, and date ranges, returning paginated results most recent first","exampleAgentPrompt":"Search Twitter for tweets from @elonmusk mentioning 'bitcoin' that have at least 100 likes since 2024-01-01 — show me the most recent ones.","exampleUseCases":null,"resultDescription":"Returns an X v2 API-compatible JSON object with up to 20 tweets per page sorted most recent first, including tweet text, author info, engagement metrics (likes, replies, reposts), and a next_token cursor for pagination to retrieve subsequent pages.","failureModes":["No filter provided — at least one query parameter is required","Invalid date format — since/until must be YYYY-MM-DD","Unknown username in from/to/mentioning fields","minLikes/minReplies/minReposts must be numeric strings","Invalid or expired next_token returns no results","Rate limiting or payment failure returns 402 Payment Required","No matching tweets returns empty results array"],"whenToPreferThis":"Use this endpoint when you need to search Twitter/X tweets with fine-grained filters such as specific keywords, exact phrases, hashtags, authors, mentions, engagement thresholds, or date windows — especially when you want X v2 API-compatible JSON output and need pagination support. Prefer this over general web search when the target is specifically Twitter content with structured filtering.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":544,"lastUsedAt":"2026-07-18T01:43:07.755Z","lastSuccessfullyRanAt":"2026-07-18T01:43:07.755Z","lastHealthCheckAt":"2026-10-17T18:30:58.771Z","isFirstParty":false,"canonicalSlug":"x402-twit-sh-35962144"}