{"uid":"cap_PjjL506USnfxu1-oAkWQn","slug":"payweave-twitter-follow-relationship-lookup-2b9094c9","name":"PayWeave Twitter – Follow Relationship Lookup","description":"X/Twitter data — tweets, users, communities, lists, articles, and trends.","url":"https://twitter.payweave.services/users/follow-relationship","method":"GET","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":{"anyOf":[{"not":{}},{"type":"object","required":["source","target"],"properties":{"source":{"type":"string","minLength":1,"description":"Handle of the source user (without @)."},"target":{"type":"string","minLength":1,"description":"Handle of the target user (without @)."}},"additionalProperties":false}]},"type":{"type":"string","const":"http"},"method":{"type":"string","const":"GET"},"bodyType":{"type":"string","const":"json"}},"additionalProperties":false},"output":{"type":"object","required":["example"],"properties":{"example":{"type":"object","properties":{"data":{"type":"object","properties":{"following":{"type":"boolean","description":"True if source follows target."},"followed_by":{"type":"boolean","description":"True if target follows source."}},"additionalProperties":true},"status":{"type":"string"}},"description":"Follow-relationship JSON forwarded verbatim from twitterapi.io.","additionalProperties":true}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.00177","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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.00177/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.00177","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.00177","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_aN7mJ4ZlDFJnfWX-3XzpF","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.00177","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Checks whether two Twitter/X users follow each other by returning bidirectional follow relationship flags for a source and target handle pair.","exampleAgentPrompt":"Check if the Twitter user 'openai' follows 'sama' and whether 'sama' follows them back — give me the bidirectional follow relationship.","exampleUseCases":[{"title":"Influencer audience overlap check","prompt":"I want to know if the Twitter account 'nytimes' follows 'washingtonpost' and whether 'washingtonpost' follows them back — can you check the follow relationship both ways?"},{"title":"Mutual follow verification before DM campaign","prompt":"Before we send outreach, check if the Twitter handle 'techcrunch' follows our account 'startupxyz' — I need to know if they follow us back or not."},{"title":"Social graph analysis for competitive research","prompt":"Does 'elonmusk' follow 'jeffbezos' on X, and does 'jeffbezos' follow 'elonmusk' back? Pull the follow relationship for both directions."}],"resultDescription":"Returns a JSON object with two boolean fields: 'following' (true if the source handle follows the target) and 'followed_by' (true if the target follows the source back), forwarded verbatim from twitterapi.io, along with a status string.","failureModes":["Invalid or non-existent handle returns an error or empty data object","Missing required 'source' or 'target' fields causes a validation error","Rate limiting or upstream twitterapi.io outage results in a failed response","Handle provided with '@' prefix may cause lookup failure (handles must be without '@')","Private/suspended accounts may return incomplete or null relationship data"],"whenToPreferThis":"Choose this endpoint when you need a lightweight, pay-per-call check of the directional follow relationship between exactly two Twitter/X users without requiring full OAuth user auth or a Twitter developer account. It's ideal for agents doing social graph enrichment, audience verification, or pre-campaign targeting checks at low cost ($0.00177/call).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:51:27.983Z","isFirstParty":false}