{"uid":"cap_3HhROGkbBwJZ_Mu0FZRhY","slug":"twitter-x-tweet-search-api-x402atlas-9e664586","name":"Twitter/X Tweet Search API (x402atlas)","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://twit.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"],"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":null,"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":"down","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_d0mVVHa2sHPq_WDZoHm-1","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 tweets using structured filters and raw X search syntax, returning up to 20 tweets per page with full text, author profile, and engagement metrics.","exampleAgentPrompt":"Can you find the latest tweets from @elonmusk about bitcoin that have at least 500 likes, posted since January 1 2025? Return the most recent ones first.","exampleUseCases":[{"title":"Track brand mentions on Twitter","prompt":"Can you search Twitter for all tweets mentioning @Nike from the past week that have at least 100 likes? I want to see what people are saying about the brand and how much engagement those posts are getting."},{"title":"Monitor trending hashtag engagement","prompt":"Find the most popular tweets using the hashtag #CES2025 posted between January 7 and January 10 2025. Sort by highest engagement and show me the full text along with likes and retweets for each one."},{"title":"Competitor social media research","prompt":"Can you pull recent tweets from @OpenAI about their new product launches that have gotten at least 1000 likes? I'm trying to understand what announcements are resonating most with their audience."}],"resultDescription":"A JSON object containing up to 20 tweets per page, each with full tweet text, author profile information, engagement metrics (likes, retweets, replies, quotes, views), tweet ID, and a pagination cursor for fetching subsequent pages.","failureModes":["No results found for the given filter combination — returns empty tweet list","Invalid date format for since/until parameters — returns 400 error","Missing required search parameter (at least one of words, phrase, any_words, hashtags, from, to, mentioning, search_query) — returns 400 error","Invalid cursor value causes pagination failure","Rate limiting or payment failure returns 402 or 429 error","Extremely restrictive filter combinations (e.g. very high min_likes with rare keywords) yield zero results"],"whenToPreferThis":"Use this endpoint when you need to search or monitor Twitter/X content with structured filters like keyword combinations, user-specific tweets, hashtag tracking, engagement thresholds, or date ranges. Prefer this over generic web search when the goal is specifically Twitter/X data with rich engagement metrics and pagination support.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:39:14.459Z","isFirstParty":false}