{"uid":"cap_W1_nZaAThbCB90pismI81","slug":"twitter-x-tweet-search-api-7deef50d","name":"Twitter/X Tweet Search API","description":"Search Twitter/X for tweets matching a query -- returns up to 20 results with text, engagement, author, and timestamps.","url":"https://twitter-scraper.api.klymax402.com/api/search","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"count":{"type":"number","description":"Number of tweets to return (1-20, default 10)"},"query":{"type":"string","description":"Search query -- supports keywords, phrases, hashtags (#), mentions (@), and operators (from:user, since:2026-01-01)"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.012","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.012/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.012","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.012","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_eHF4xD8j0VfUuYcvgm-EB","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.012","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Searches Twitter/X for tweets matching a query and returns up to 20 results with text, engagement metrics, author info, and timestamps.","exampleAgentPrompt":"Search Twitter for the top 15 tweets about 'OpenAI GPT-5' posted since 2025-01-01 and show me the text, author, and engagement numbers for each.","exampleUseCases":[{"title":"Brand mention monitoring on X","prompt":"Search Twitter for the last 20 tweets mentioning '@NikeSupport' or '#NikeComplaint' so I can see what customers are saying about Nike's support experience right now."},{"title":"Tracking breaking news reactions","prompt":"Find 15 tweets about the latest Federal Reserve interest rate decision on Twitter — I want to see what people are saying, who's posting, and how much engagement each tweet is getting."},{"title":"Competitive hashtag research","prompt":"Search X for tweets using the hashtag #SustainableFashion from the past week — give me 20 results with the authors and engagement stats so I can see which voices are dominating that conversation."}],"resultDescription":"Returns up to 20 tweet objects, each containing the tweet text, author handle and display name, engagement metrics (likes, retweets, replies), and publication timestamp. Results are matched to the search query and may include keyword, hashtag, mention, and operator-based filtering.","failureModes":["No tweets found for the query — returns empty results","Query syntax errors (malformed operators) may return unexpected results","Twitter rate limiting or scraping blocks may cause partial or failed responses","Date-based filters (since:) may yield no results if the timeframe is too narrow","Count values outside 1-20 range may be clamped or cause errors"],"whenToPreferThis":"Choose this endpoint when you need to retrieve real-time or recent public tweet data for a given keyword, hashtag, mention, or user-based query, especially in agentic workflows requiring social listening, brand monitoring, or trend analysis. Prefer this over general web search when you specifically need structured tweet data with engagement metrics and author attribution from Twitter/X.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:35:43.290Z","isFirstParty":false}