{"uid":"cap_aTQsQJlmB6LeUgx-NC5yX","slug":"twitter-x-search-api-b281b9a1","name":"Twitter/X Search API","description":"Search Twitter/X with structured filters or raw advanced-search syntax. Returns up to 20 normalized tweets with full text, author details, engagement metrics and a pagination cursor.","url":"https://twitter.use.x402atlas.com/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":{"words":{"type":"string","description":"Tweets containing all these words"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"type":{"enum":["top","latest","media"],"type":"string","description":"Result ranking used for this page"},"query":{"type":"string","description":"The assembled X advanced-search query string sent upstream"},"cursor":{"type":"string","description":"Pagination cursor for the next page, if any"},"tweets":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Tweet ID"},"lang":{"type":"string","description":"BCP-47 language code"},"text":{"type":"string"},"urls":{"type":"array","items":{"type":"string"},"description":"Expanded URLs linked in the tweet"},"likes":{"type":"integer"},"views":{"type":"integer"},"author":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"avatar":{"type":"string"},"verified":{"type":"boolean","description":"Blue-check verification status"},"followers":{"type":"integer"},"description":{"type":"string"},"screen_name":{"type":"string"}}},"quotes":{"type":"integer"},"replies":{"type":"integer"},"is_quote":{"type":"boolean"},"retweets":{"type":"integer"},"bookmarks":{"type":"integer"},"created_at":{"type":"string","format":"date-time"},"in_reply_to_id":{"type":"string","description":"Parent tweet ID, if this is a reply"},"conversation_id":{"type":"string"},"in_reply_to_user":{"type":"string","description":"Parent tweet's author screen name, if this is a reply"}}}},"queried_at":{"type":"string","format":"date-time","description":"UTC timestamp when this bridge ran the search"},"tweet_count":{"type":"integer","description":"Number of tweets in this page"}}}}}}},"responseSchema":{"type":"json","example":{"type":"top","query":"from:@PancakeSwap filter:replies","cursor":"DAACCgACHMe1FCaAJxAKAAMcx7UU…","tweets":[{"id":"2071965671001608665","lang":"en","text":"Stack your tokenized assets ⬇️\nhttps://t.co/peohoKiMyQ","urls":["https://pancakeswap.finance/stocks"],"likes":16,"views":3534,"author":{"id":"1305349277422477313","name":"PancakeSwap","avatar":"https://pbs.twimg.com/profile_images/2004910939959967744/wr7-zpVh_normal.jpg","verified":true,"followers":2132825,"description":"Everyone's favorite DEX. Swap, trade, and earn across 10+ chains.","screen_name":"PancakeSwap"},"quotes":0,"replies":1,"is_quote":false,"retweets":2,"bookmarks":0,"created_at":"2026-06-30T14:34:45Z","conversation_id":"2071965667491000381"}],"queried_at":"2026-07-05T12:00:00Z","tweet_count":1}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_fLszNXd5_xYO1Hvab50jv","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search Twitter/X posts using keywords or advanced-search syntax, returning up to 20 normalized tweets with full text, author details, and engagement metrics.","exampleAgentPrompt":"Search Twitter/X for the latest tweets containing the words 'OpenAI GPT-5' and show me the top results with engagement metrics like likes, retweets, and views.","exampleUseCases":[{"title":"Brand mention monitoring","prompt":"Search Twitter for recent tweets mentioning 'Acme Corp product launch' and give me the top posts by engagement — I want to see what people are saying, including likes and retweet counts."},{"title":"Breaking news tweet discovery","prompt":"Find the latest tweets about the earthquake in Tokyo on X — show me the most recent posts with full text and author info so I can gauge how the story is developing."},{"title":"Competitor sentiment analysis","prompt":"Pull tweets from Twitter/X that contain 'Notion AI' and show me the engagement numbers — likes, replies, and views — so I can analyze public sentiment about the product."}],"resultDescription":"Returns up to 20 tweet objects, each containing the tweet ID, full text, BCP-47 language code, creation timestamp, expanded URLs, and a nested author object (ID, name, screen name, avatar, follower count, bio, verification status) plus engagement counts (likes, retweets, replies, quotes, views, bookmarks). Also returns the assembled advanced-search query string, result ranking type (top/latest/media), a pagination cursor for the next page, and the UTC timestamp when the query was executed.","failureModes":["Missing or invalid 'words' query parameter returns no results or an error","Rate limiting or upstream Twitter API restrictions may return empty results","Private or suspended accounts' tweets will not appear in results","Pagination cursor expiry may prevent deep pagination","Network timeout from upstream X API causing delayed or failed responses","Ambiguous query keywords may return irrelevant tweets"],"whenToPreferThis":"Use this endpoint when you need to search public Twitter/X posts by keyword or phrase and require normalized, structured output including full author profiles and engagement metrics. Prefer this over building your own Twitter scraper or using the official Twitter API directly when cost predictability per call ($0.005 USDC) and simplified schema normalization matter. Choose this over sibling endpoints (user timeline, media timeline, lists) when you are doing open keyword search rather than fetching posts from a known specific user or community.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:39:58.958Z","isFirstParty":false}