{"uid":"cap_8ehjaTN_QVtk5jUJPqRdk","slug":"glim-sh-twitter-users-lookup-9195197d","name":"glim.sh Twitter Users Lookup","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/users","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 user 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"}}}}}}}}},"responseSchema":{"type":"json","example":{"data":[{"id":"44196397","username":"cascade_fyi"}],"meta":{"result_count":1}}},"example":{"request":{"ids":"44196397"},"response":{"data":[{"id":"44196397","name":"Elon Musk","username":"elonmusk","verified":true,"created_at":"2009-06-02T20:12:29.000Z","description":"http://Terafab.ai","public_metrics":{"like_count":234926,"media_count":4552,"tweet_count":104374,"followers_count":240291303,"following_count":1357},"cover_image_url":"https://pbs.twimg.com/profile_banners/44196397/1774145451","pinned_tweet_ids":["2066538446781382800"],"profile_image_url":"https://pbs.twimg.com/profile_images/2053244804520427520/m8mdWZCG_normal.jpg"}],"meta":{"result_count":1,"has_next_page":false}}},"exampleRequest":{"ids":"44196397"},"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_4Php-Wjn41Xs5acZ24idN","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":"Looks up Twitter/X user profiles by username or user ID, returning account metadata without requiring your own API keys.","exampleAgentPrompt":"Can you look up the Twitter user @cascade_fyi and tell me their user ID and any other profile info available?","exampleUseCases":[{"title":"Verify Twitter handles in user database","prompt":"I need to check if these Twitter handles are still active accounts and get their current user IDs: @techcrunch, @vergetech, and @arstechnica. Can you look them up for me?"},{"title":"Enrich social mentions with account data","prompt":"Someone mentioned @paulgraham in our support emails. Can you look up that Twitter account and confirm it exists, and get me their user ID for our records?"},{"title":"Bootstrap agent workflow with Twitter lookup","prompt":"I want to monitor some Twitter accounts for our market research. Can you start by looking up @elonmusk, @satyanadella, and @sundarpichai to get their user IDs so we can set up tracking?"}],"resultDescription":"Returns a JSON object with a data array of matched Twitter user objects (each containing id and username) and a meta object with result_count indicating how many users were found.","failureModes":["Username not found — empty data array returned","Invalid username format causes request error","Payment failure via x402 protocol results in 402 response and no data","Rate limiting or downstream Twitter API errors may return 5xx","Suspended or deactivated accounts may return no results"],"whenToPreferThis":"Use this endpoint when an agent needs to resolve Twitter/X usernames to user IDs (or vice versa) without setting up Twitter API credentials. Ideal for enriching social data pipelines, verifying account existence, or bootstrapping Twitter-based workflows using pay-per-call microtransactions instead of managing OAuth tokens.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:41:20.264Z","isFirstParty":false}