{"uid":"cap_gvvRnY3SNQdPvku-uJeVI","slug":"x402-atlas-twitter-x-tweet-search-4d84d117","name":"X402 Atlas Twitter/X Tweet Search","description":"Search Twitter/X tweets with structured filters. Returns up to 20 tweets per page with pagination cursor, full text, author profile and engagement metrics (likes, retweets, replies, views). Params: words, phrase, any_words, none_words, hashtags, from, to, mentioning, filter, min_likes, min_retweets, min_replies, since, until, within_time, near, since_id, max_id, type (top|latest), cursor; search_query takes raw X search syntax. e.g. GET /search?words=bitcoin&from=elonmusk&min_likes=100.","url":"https://tweets.use.x402atlas.com/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 sent in reply to this username"},"from":{"type":"string","description":"Tweets sent by this username (@ optional), e.g. elonmusk"},"near":{"type":"string","description":"Tweets geotagged near this location, e.g. Berlin or The Hague"},"type":{"enum":["top","latest"],"type":"string","description":"Result ranking: top (default) or latest. Latest returns tweets in descending ID order — paginate with cursor or max_id."},"since":{"type":"string","description":"Tweets on or after this date, YYYY-MM-DD"},"until":{"type":"string","description":"Tweets before this date, YYYY-MM-DD"},"words":{"type":"string","description":"Tweets containing all these words, e.g. what's happening. At least one of words, phrase, any_words, hashtags, from, to, mentioning, search_query is required."},"cursor":{"type":"string","description":"Pagination cursor from the previous response"},"filter":{"type":"string","description":"Comma-separated content filters: replies, links, quote, media, images, videos"},"max_id":{"type":"string","description":"Tweets at or before this tweet ID (inclusive) — crawl a timeline backward by passing the lowest ID from the current page"},"phrase":{"type":"string","description":"Tweets containing this exact phrase, e.g. happy hour"},"hashtags":{"type":"string","description":"Tweets with these hashtags (comma or space separated, # optional), e.g. ThrowbackThursday"},"since_id":{"type":"string","description":"Tweets after this tweet ID (exclusive)"},"any_words":{"type":"string","description":"Tweets containing any of these words (comma or space separated), e.g. cats,dogs"},"min_likes":{"type":"string","description":"Tweets with at least this many likes, e.g. 280"},"mentioning":{"type":"string","description":"Tweets mentioning this username"},"none_words":{"type":"string","description":"Exclude tweets containing any of these words (comma or space separated)"},"min_replies":{"type":"string","description":"Tweets with at least this many replies"},"within_time":{"type":"string","description":"Tweets within a recent window: 30s, 5m, 3h or 2d"},"min_retweets":{"type":"string","description":"Tweets with at least this many reposts"},"search_query":{"type":"string","description":"Raw X advanced search syntax escape hatch, combined with the structured params above"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"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_IrH36EffN7BUi4H1css6U","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 (keywords, user, hashtags, engagement thresholds, date ranges) and returns paginated tweet results with full text, author profiles, and engagement metrics","exampleAgentPrompt":"Search for the top tweets mentioning 'bitcoin' from Elon Musk since 2024-01-01 that have at least 100 likes, and show me the latest results with full engagement metrics.","exampleUseCases":null,"resultDescription":"Returns up to 20 tweets per page including full tweet text, author username and profile info, engagement metrics (likes, retweets, replies, views), tweet IDs, and a pagination cursor to fetch the next page of results.","failureModes":["No tweets found matching the query — empty results array returned","Invalid date format for since/until — 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 — may return empty or unexpected results","Rate limiting or payment failure — returns 402 Payment Required","Twitter/X API unavailability — may return 503 or timeout"],"whenToPreferThis":"Use this endpoint when you need to search and filter Twitter/X tweets with fine-grained control over keywords, users, hashtags, engagement thresholds, date ranges, and tweet types. Prefer this over generic web search when the task specifically requires Twitter data with structured engagement metrics and pagination support. Well-suited for social listening, trend monitoring, influencer research, or competitive analysis tasks.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T19:25:58.619Z","isFirstParty":false,"canonicalSlug":"x402-atlas-twitter-x-tweet-search-4d84d117"}