{"uid":"cap_Mh8SB36uS-_9FcuPFKPby","slug":"glim-sh-twitter-user-relationship-lookup-a6edc6c2","name":"glim.sh Twitter User Relationship Lookup","description":"Check follow relationship","url":"https://glim.sh/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_9oDr2P6RZqyomqdN_JeFQ","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, returning whether one follows or is followed by the other.","exampleAgentPrompt":"Can you check whether @elonmusk follows @jack back on Twitter — does he follow them, and does @jack follow him?","exampleUseCases":[{"title":"Verify influencer partnership requirements","prompt":"Before we pitch this brand partnership, can you check if the company's official Twitter account follows our creator? And does our creator follow them back? I want to know if there's already a mutual relationship there."},{"title":"Research competitor social connections","prompt":"I'm tracking our main competitors in the space. Can you check if @TechCorp follows @InnovateLabs on Twitter? I'm trying to map out who's connected to who in this industry."},{"title":"Validate user credibility for support","prompt":"A user just opened a support ticket claiming they're a partner. Can you quickly verify if their Twitter handle actually follows our official company account? That would help us confirm if they're legit."}],"resultDescription":"A JSON object with a 'data' field containing 'following' (boolean indicating if the source user follows the target) and 'followed_by' (boolean indicating if the target follows the source back).","failureModes":["Invalid or nonexistent Twitter username returns an error","Private/suspended accounts may not return relationship data","Rate limits or upstream Twitter API downtime may cause failures","Missing required user identifiers result in bad request errors","Payment failure (402) if USDC balance is insufficient"],"whenToPreferThis":"Use this endpoint when you need to quickly determine the directional follow relationship between two specific Twitter/X users without managing Twitter API keys or building a scraping pipeline. Ideal for social graph analysis, influencer research, or verifying mutual follows at $0.001 per call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:47:04.240Z","isFirstParty":false}