{"uid":"cap_azUeWscapXM9H31ORsgc3","slug":"glim-sh-twitter-search-12dfedd2","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://glim.sh/api/v1/twitter/search?utm_source=zero.xyz","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":3,"rating":{"score":"0.92","successRate":"0.99","reviews":3,"stars":"4.7","state":"rated"},"availabilityStatus":"healthy","priceObserved":{"p10Cents":"0.5000","medianCents":"0.5000","p90Cents":"0.5000","minCents":"0.5000","maxCents":"0.5000","p95Cents":"0.5000","sampleCount":102,"varies":false,"failureChargeRate":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_5yh60yuRiWyyzu_xhlZLd","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 for tweets matching a query with optional date filtering, sorting, and pagination, without needing a Twitter API key.","exampleAgentPrompt":"Search Twitter for the latest tweets about the OpenAI GPT-5 release from the past week — sort by Latest and show me the first page of results.","exampleUseCases":null,"resultDescription":"Returns a JSON object containing an array of matched tweets (each with tweet ID, text, and author username), a total count, a boolean indicating if more results exist, and a pagination cursor for fetching the next page.","failureModes":["Invalid or missing query returns an error","Malformed date format causes a 400 bad request","Invalid sort enum value rejected","Expired or invalid cursor causes pagination error","Rate limit or payment failure returns a 402 or 429 response","No matching tweets returns an empty tweet array with count 0"],"whenToPreferThis":"Use this endpoint when you need to search Twitter/X for tweets matching keywords, hashtags, or advanced operators without setting up a Twitter developer account or managing API keys. Ideal for agents that need live social media data on demand, with flexible date filtering and pagination support.","instructions":null,"reviewSummary":"glim.sh delivers reliable Twitter/X search with advanced operator support, consistently returning full metadata including timestamps, source links, attachment data, and engagement counters across all reviewed queries. Accuracy is rated high, with results described as highly relevant when using account-filtered or engagement-filtered operators. Minor caveats include the need for client-side validation of coverage and result sorting.","reviewSummaryHighlights":["Consistently returns rich metadata: timestamps, engagement counters, source links, and attachment info","Advanced operator support (from:, min_faves:, etc.) yields narrow, highly relevant results","Perfect reliability score across all reviews"],"reviewSummaryConcerns":["Coverage completeness and result sorting may require client-side validation"],"reviewSummaryGeneratedAt":"2026-10-18T20:15:11.636Z","activationCount":161,"lastUsedAt":"2026-10-17T19:34:31.600Z","lastSuccessfullyRanAt":"2026-10-17T19:34:31.600Z","lastHealthCheckAt":"2026-10-22T18:29:18.253Z","isFirstParty":false,"canonicalSlug":"glim-sh-twitter-search-12dfedd2"}