{"uid":"cap_Q5jRADGhrLWrKGxUX4Bqv","slug":"glim-sh-twitter-search-0137b723","name":"glim.sh Twitter Search","description":"Search tweets with advanced operators (recommended). Body param is `query` (not q), e.g. {\"query\":\"from:elonmusk AI min_faves:100\"}","url":"https://surf.cascade.fyi/api/v1/twitter/search","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"sort":{"enum":["latest","top"],"type":"string","description":"Sort order: \"top\" (most engaged matching tweets) or \"latest\" (newest first). Default: \"top\"."},"query":{"type":"string","maxLength":1000,"minLength":1,"description":"Search query with advanced operators"},"cursor":{"type":"string","maxLength":500,"description":"Pagination cursor"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d+)?)?(Z|[+-]\\d{2}:?\\d{2}))?$","description":"Only tweets before this time. YYYY-MM-DD (inclusive through end of day UTC) or ISO 8601 datetime with Z/offset (e.g. 2026-04-13T14:30:00Z)"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}(:\\d{2}(\\.\\d+)?)?(Z|[+-]\\d{2}:?\\d{2}))?$","description":"Only tweets on or after this time. YYYY-MM-DD (UTC midnight) or ISO 8601 datetime with Z/offset (e.g. 2026-04-13T14:30:00Z)"},"expand_urls":{"type":"boolean","default":false,"description":"When true, auto-crawl entity URLs and attach crawled_content to tweets. Off by default: responses can grow by up to 4KB per expanded URL. Use glim_web_crawl(url) for targeted crawls instead."}}},"responseSchema":{"type":"json","example":{"count":1,"tweets":[{"id":"123","text":"Hello","author":{"username":"elonmusk"}}],"has_more":true,"next_cursor":"abc123"}},"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_xZ7ZRq10SVwJY-t2mDd_O","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search Twitter/X in real time with advanced query operators, returning tweets, authors, and pagination — no API keys required.","exampleAgentPrompt":"Search Twitter for the latest tweets about the Nvidia earnings report, sorted by Latest, from the past 3 days — I want to see what people are saying right now.","exampleUseCases":null,"resultDescription":"A JSON object containing an array of tweets (each with tweet ID, text, and author username), a total count, a has_more boolean, and a next_cursor string for paginating through additional results.","failureModes":["Invalid or empty query string returns no results or error","Malformed date formats (not YYYY-MM-DD or ISO 8601) cause a parsing error","Invalid sort enum value (anything other than 'Latest' or 'Top') rejected","Expired or invalid pagination cursor returns error or restarts results","Rate limiting or payment failure returns 402 or 429 status","Twitter API downtime causes upstream errors"],"whenToPreferThis":"Use this endpoint when you need live, real-time Twitter search without managing your own Twitter API credentials or scraping infrastructure. Ideal for agents that need to monitor breaking news, brand mentions, hashtags, or public sentiment on X/Twitter, especially when queries involve advanced operators or date-scoped retrieval. Prefer this over self-managed Twitter API integrations when you want pay-per-call pricing with no setup.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:39:31.722Z","isFirstParty":false}