{"uid":"cap_1UOUXwrAmgBAB8WDBnm8_","slug":"glim-sh-twitter-tweets-fetch-cb402897","name":"glim.sh Twitter Tweets Fetch","description":"One remote endpoint gives your agent live data from Twitter, Reddit, the open web, GitHub and more. No API keys, no scraping stack - just connect the URL and go.","url":"https://surf.cascade.fyi/api/v1/twitter/tweets","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","required":["ids"],"properties":{"ids":{"type":"string","description":"Comma-separated tweet IDs"}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"meta":{"type":"object","required":["result_count"],"properties":{"next_cursor":{"type":"string"},"result_count":{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991},"has_next_page":{"type":"boolean"}}},"summary":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}}}}}}},"responseSchema":{"type":"json","example":{"data":[{"id":"1234567890","text":"Example tweet"}],"meta":{"result_count":1}}},"example":{"request":{"ids":"1234567890,1234567891,1234567892"},"response":{"data":[{"id":"1234567890","url":"https://x.com/pathfinderSport/status/1234567890","lang":"el","text":"Αρσεναλ - Σάντερλαντ: (X) 0-0 τελικό","author":{"id":"18934481","name":"Pathfinder Sports","location":"Heraklion, Crete","username":"pathfinderSport","created_at":"2009-01-13T10:15:21.000Z","description":"Αθλητικά νέα από το Pathfinder Sports","public_metrics":{"like_count":0,"media_count":0,"tweet_count":109506,"followers_count":3429,"following_count":6},"profile_image_url":"https://pbs.twimg.com/profile_images/71248884/twitter-icons_normal.jpg"},"is_quote":false,"is_reply":false,"time_ago":"903w ago","created_at":"2009-02-21T16:55:22.000Z","is_retweet":false,"content_type":"original","public_metrics":{"like_count":7746,"quote_count":5745,"reply_count":14461,"retweet_count":5485,"bookmark_count":4974,"impression_count":0},"conversation_id":"1234567890","is_thread_start":true,"in_reply_to_user_id":""},{"id":"1234567891","url":"https://x.com/still_smoking/status/1234567891","lang":"en","text":"made fudge chip muffins for Sean and blueberry for me","author":{"id":"20372901","name":"Sean","location":"ÜT: 41.508553,-74.211821","username":"still_smoking","created_at":"2009-02-08T15:43:27.000Z","public_metrics":{"like_count":0,"media_count":240,"tweet_count":46527,"followers_count":377,"following_count":548},"profile_image_url":"https://pbs.twimg.com/profile_images/744951957966688256/Y-U3goWx_normal.jpg"},"is_quote":false,"is_reply":false,"time_ago":"903w ago","created_at":"2009-02-21T16:55:22.000Z","is_retweet":false,"content_type":"original","public_metrics":{"like_count":35,"quote_count":54,"reply_count":751,"retweet_count":12,"bookmark_count":11,"impression_count":0},"conversation_id":"1234567891","is_thread_start":true,"in_reply_to_user_id":""},{"id":"1234567892","url":"https://x.com/maximetoulliou/status/1234567892","lang":"fr","text":"rt @neo:  A lire chez @TiBo http://tinyurl.com/awprzc","author":{"id":"10771862","name":"Max Toulliou","location":"London","username":"maximetoulliou","created_at":"2007-12-01T19:48:40.000Z","description":"Director, Customer Success @InfoSum • Digital Advertising • Cyclist w/ @brixton_cc • French 🇫🇷","public_metrics":{"like_count":0,"media_count":194,"tweet_count":10049,"followers_count":801,"following_count":790},"profile_image_url":"https://pbs.twimg.com/profile_images/855095074794942464/mxp_aOvp_normal.jpg"},"entities":{"mentions":[{"username":"neo"},{"username":"TiBo"}]},"is_quote":false,"is_reply":false,"time_ago":"903w ago","created_at":"2009-02-21T16:55:22.000Z","is_retweet":false,"content_type":"original","public_metrics":{"like_count":14,"quote_count":26,"reply_count":448,"retweet_count":6,"bookmark_count":9,"impression_count":0},"conversation_id":"1234567892","is_thread_start":true,"in_reply_to_user_id":""}],"meta":{"result_count":3,"has_next_page":false}}},"exampleRequest":{"ids":"1234567890,1234567891,1234567892"},"tags":["x402"],"displayCostAmount":"0.004","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Lr8mwMbDz3TMfXMf3BrKl","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches live tweets from Twitter/X via a pay-per-call proxy endpoint requiring no API keys","exampleAgentPrompt":"Search Twitter right now for the latest tweets mentioning 'OpenAI' and give me the top 10 results — I don't have a Twitter API key so use a proxy service.","exampleUseCases":[{"title":"Monitor competitor brand mentions in real-time","prompt":"Watch Twitter right now for any tweets mentioning our competitors and summarize what people are saying about them — I need to track this without setting up API credentials."},{"title":"Track social sentiment around product launches","prompt":"Pull the latest tweets about our product launch happening today and show me the overall sentiment — I want live data without dealing with API key management."},{"title":"Find trending discussion topics for content ideas","prompt":"Search X right now for tweets discussing AI trends in the last hour and cluster them by theme — help me discover what's hot without needing Twitter credentials."}],"resultDescription":"Returns a JSON object with a 'data' array of tweet objects (each containing id and text fields) and a 'meta' object with result_count, representing live tweets matching the query.","failureModes":["Payment not received — returns 402 if USDC payment is not included","Invalid query parameters — returns 400 if tweet search params are malformed","Twitter API upstream error — returns 502 if the underlying Twitter API is unavailable","Rate limit exceeded — returns 429 if call volume is too high","No results found — returns empty data array if no tweets match the query"],"whenToPreferThis":"Use this endpoint when an agent needs live Twitter/X data without managing Twitter API credentials or a scraping infrastructure, and is willing to pay $0.004 USDC per call. Prefer this over direct Twitter API integration when operating in a serverless or key-free environment, or when rapid prototyping social listening pipelines.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:45:31.324Z","isFirstParty":false}