{"uid":"cap_JfpjrUiPJRzcrfo1zRZVR","slug":"squeezeos-x-twitter-search-api-5d57d204","name":"SqueezeOS X (Twitter) Search API","description":"Public X/Twitter search API for AI agents. Search recent public posts by keyword without requiring the caller to maintain a separate X developer account.","url":"https://squeezeos-api.onrender.com/api/x/search","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input","output"],"properties":{"input":{"type":"object","required":["type","method","queryParams"],"properties":{"type":{"type":"string","const":"http"},"method":{"type":"string","const":"GET"},"queryParams":{"type":"object","required":["q"],"properties":{"q":{"type":"string","maxLength":512,"minLength":1,"description":"Public X search query Search intents: x search, twitter search, social search, public posts, social research."},"type":{"enum":["Latest","Top"],"type":"string","description":"Search intents: x search, twitter search, social search, public posts, social research."},"max_results":{"enum":["1","2","3","4","5","6","7","8","9","10"],"type":"string","description":"Search intents: x search, twitter search, social search, public posts, social research."}},"additionalProperties":true}},"additionalProperties":false},"output":{"type":"object","required":["type","example"],"properties":{"type":{"type":"string","const":"json"},"example":{"type":"object"}},"additionalProperties":false}},"additionalProperties":false},"responseSchema":{"type":"json","example":{"type":"Latest","query":"x402","status":"ready","product":"SML Public X Search","results":[{"id":"<public-post-id>","url":"https://x.com/<public-handle>/status/<public-post-id>","text":"<public-post-text>","author":{"username":"<public-handle>"},"created_at":"<source-timestamp>"}],"provenance":{"provider":"twitterapis","public_read_only":true},"result_count":1}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.0048","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.0048/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0048","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0048","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_wHDuc2slHGXZ48KVIQNPG","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0048","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search recent public X (Twitter) posts with structured output including source IDs and timestamps, returning up to 10 results per query","exampleAgentPrompt":"Search X for the latest 5 posts about 'NVIDIA earnings' and give me the results with their post IDs and timestamps.","exampleUseCases":[{"title":"Track breaking news on X","prompt":"Find the 10 most recent X posts about the Federal Reserve interest rate decision today — I want to see what people are saying right now, with timestamps."},{"title":"Monitor stock ticker sentiment","prompt":"Search X for the latest posts mentioning $TSLA and show me the top 5 with their source IDs and when they were posted."},{"title":"Competitive brand mention research","prompt":"Look up the most recent public posts on X about 'OpenAI GPT-5' — get me up to 8 results sorted by Latest so I can see the freshest reactions."}],"resultDescription":"A structured JSON response containing up to 10 X posts matching the query, each with post content, source IDs, and timestamps. Results can be filtered by Latest or Top post type.","failureModes":["Empty results if query matches no recent public posts","Rate limiting or payment failure if USDC payment not processed","Query too long if search string exceeds 512 characters","Invalid enum value for 'type' parameter (must be 'Latest' or 'Top')","max_results out of allowed range (must be string '1' through '10')","X API downtime or throttling causing upstream failures"],"whenToPreferThis":"Use this endpoint when you need structured, timestamped X post data with source IDs for a specific search query — especially useful for real-time social sentiment, news monitoring, or market intelligence workflows where provenance (post IDs) matters. Prefer this over generic web search when you specifically need X posts with metadata rather than web pages or news articles.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-16T06:43:27.604Z","isFirstParty":false}