{"uid":"cap_jS1RcDuusYY0dgE1G1X8U","slug":"otto-ai-tweet-search-dc1e0277","name":"Otto AI Tweet Search","description":"Search X/Twitter for any query and get the actual matching tweets — keyword, $CASHTAG, from:handle (a user timeline), @handle (mentions), or boolean OR. Each tweet returns author, full text (long-form note tweets included), timestamp, likes and retweets (reply/quote counts when available). Most-recent-first for real-time monitoring and alerting. Live X search backend, pay-per-call USDC, structured JSON.","url":"https://x402.ottoai.services/tweet-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","required":["query"],"properties":{"query":{"type":"string","description":"X/Twitter search query. Plain keywords/topics, a $CASHTAG, from:handle for a user timeline, @handle for mentions, or boolean OR (uppercase). Example: \"$BTC OR bitcoin -is:retweet\"."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["status"],"properties":{"data":{},"meta":{"type":"object"},"reason":{"type":"string","description":"status=unavailable only; every >=400 is UNCHARGED"},"status":{"enum":["success","unavailable"],"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"data":{"mode":"Latest","count":2,"query":"$BTC","tweets":[],"generatedAt":"2026-06-30T13:45:00.000Z"},"meta":{"degraded":false,"validUntil":"","generatedAt":"","stalenessSec":0},"status":"success"}},"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_uJEAMO4VtKYDmDAGBuQMw","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 X/Twitter for recent tweets by keyword, cashtag, user handle, or boolean query and return structured tweet data","exampleAgentPrompt":"Search X/Twitter for the latest tweets about $BTC — include any mentions of Bitcoin price action, whale movements, or technical analysis from the past few hours.","exampleUseCases":null,"resultDescription":"Returns a list of recent tweets matching the query, each with tweet ID, URL, full text, author handle, like/retweet/reply/quote counts, creation timestamp, and a long-form flag. Also includes metadata such as query mode, result count, and a generatedAt freshness timestamp.","failureModes":["Missing required 'query' parameter returns a validation error","Overly broad queries may return noisy or irrelevant tweets","Rate limiting or payment failure (402) if USDC balance is insufficient","Twitter API outages may cause degraded or empty responses (check meta.degraded flag)","Very new or obscure handles may return no results"],"whenToPreferThis":"Use this endpoint when you need real-time social signal or sentiment from X/Twitter specifically for crypto tokens, cashtags, or market commentary. It supports cashtag search ($BTC), user timelines (from:handle), mentions (@handle), and boolean OR queries, making it more flexible than a generic news feed. Prefer over on-chain or price-feed endpoints when the user wants qualitative social chatter, not just price data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:45:37.002Z","isFirstParty":false}