{"uid":"cap_whwQl8akDbIFbWic8gDXu","slug":"twitter-x-tweet-search-api-7b491f69","name":"Twitter/X Tweet Search API","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://twit-api-production-de12.up.railway.app/tweets/search","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":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.006","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":5,"rating":{"score":"0.77","successRate":"1.00","reviews":5,"stars":"4.1","state":"rated"},"availabilityStatus":"healthy","priceObserved":{"p10Cents":"0.6000","medianCents":"0.6000","p90Cents":"0.6000","minCents":"0.6000","maxCents":"0.6000","p95Cents":"0.6000","sampleCount":5,"varies":false,"failureChargeRate":0},"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_aD8U_wWkb1eO-CvYYLmFl","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.006","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Searches tweets on Twitter/X by keyword, hashtag, or query string and returns matching results","exampleAgentPrompt":"Search Twitter for recent tweets mentioning 'OpenAI GPT-5' and show me what people are saying about it.","exampleUseCases":[{"title":"Monitor brand mentions across social media","prompt":"Check Twitter right now for the latest tweets mentioning our company name and show me what customers and critics are saying about us."},{"title":"Track conversation around breaking news events","prompt":"Search X for recent tweets about the stock market crash today and find out what financial analysts and investors are discussing."},{"title":"Find influencer opinions on product launches","prompt":"Look up tweets from tech influencers mentioning our new AI product and show me the top posts with the most engagement so we can see how people are reacting."}],"resultDescription":"Returns a list of tweets matching the search query, including tweet text, author handles, timestamps, and other tweet metadata from Twitter/X.","failureModes":["No tweets found for query — empty results array returned","Invalid or malformed query string — 400 bad request","Rate limiting or quota exceeded — 429 too many requests","Twitter/X API upstream error or downtime — 502 or 503 response","Payment not processed — x402 payment required error","Query too broad returning irrelevant results"],"whenToPreferThis":"Use this endpoint when you need to search Twitter/X for public tweets matching a keyword, hashtag, or phrase without direct Twitter API access or developer credentials. Good for agents needing social listening, trend monitoring, or brand mention tracking on X.","instructions":null,"reviewSummary":"This Twitter/X search API reliably retrieves fresh, paginated tweet data with full metadata and returns X v2-compatible JSON. Accuracy is mixed—exact-phrase and keyword searches frequently surface relevant results but also pull in off-topic, marketing, or satirical content, requiring manual filtering and corroboration. Best suited for exploratory research or signal-detection workflows where results are verified downstream rather than consumed directly.","reviewSummaryHighlights":["Consistent uptime and reliable delivery of fresh X data across diverse search queries","Returns full tweet and author metadata in parseable, X v2-compatible JSON","Effective for exploratory research, podcast sourcing, and signal-detection workflows"],"reviewSummaryConcerns":["Exact-phrase searches often surface off-topic, satirical, or marketing content requiring manual filtering","Broad keyword queries may need additional filters (account, phrase, engagement thresholds) to improve precision","Value is limited for use cases requiring high-confidence, unverified results"],"reviewSummaryGeneratedAt":"2026-08-18T08:16:45.085Z","activationCount":17,"lastUsedAt":"2026-08-18T02:17:41.970Z","lastSuccessfullyRanAt":"2026-08-18T02:17:41.970Z","lastHealthCheckAt":"2026-09-14T18:40:45.186Z","isFirstParty":false}