{"uid":"cap_8lN2wMnJ6clXmUoS6LZFF","slug":"glim-sh-twitter-user-relationship-lookup-0547e5d9","name":"glim.sh Twitter User Relationship 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/relationship","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":["source","target"],"properties":{"source":{"type":"string","description":"Source user ID or username"},"target":{"type":"string","description":"Target user ID or username"}}},"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"],"properties":{"data":{"type":"object","required":["following","followed_by"],"properties":{"following":{"type":"boolean"},"followed_by":{"type":"boolean"}}}}}}}}},"responseSchema":{"type":"json","example":{"data":{"following":false,"followed_by":true}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_7V9VQuYgj-YxUjIGOydf3","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Checks the follow relationship between two Twitter/X users (whether user A follows user B and/or vice versa)","exampleAgentPrompt":"Can you check on Twitter whether @elonmusk follows @OpenAI, and whether @OpenAI follows him back?","exampleUseCases":[{"title":"Verify influencer partnerships and collabs","prompt":"I'm researching potential brand partnerships. Can you check if these three marketing influencers follow each other on Twitter? I want to understand if they're already connected before reaching out about a collaboration."},{"title":"Monitor competitive account relationships","prompt":"Help me keep tabs on our industry - do @TechCompanyA and @TechCompanyB follow each other on X? I'm trying to figure out if they're watching each other's moves or if there's any rivalry going on."},{"title":"Validate Twitter audience authenticity","prompt":"I bought a list of supposed industry experts on Twitter but I'm skeptical. Can you spot-check a few by seeing if they actually follow the major thought leaders in their field? That'll help me gauge if these accounts are real participants or just noise."}],"resultDescription":"Returns a JSON object with two boolean fields: 'following' (whether user A follows user B) and 'followed_by' (whether user B follows user A), indicating the directional follow relationship between the two accounts.","failureModes":["One or both usernames do not exist on Twitter — returns error or empty data","Twitter API rate limiting — may return 429 or error","Private/suspended accounts may return restricted relationship data","Malformed or missing user identifiers in request body — returns 400 error","Service unavailability — upstream Twitter API outage"],"whenToPreferThis":"Use this endpoint when you need to programmatically check follow relationships between two specific Twitter/X users without managing your own Twitter API credentials or scraping infrastructure. Ideal for social graph analysis, follower verification, influencer auditing, or any agent workflow that needs to confirm mutual follows or one-way follows on X.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:33:47.304Z","isFirstParty":false}