{"uid":"cap_9NIzSFRZPzmxiK-L3sLen","slug":"readx-x-twitter-relations-api-b9098499","name":"ReadX — X/Twitter Relations API","description":"ReadX is a read-only X/Twitter JSON API. Profiles, timelines, tweets, search, lists, followers & following — pay per call with x402 micropayments in USDC on Base or Solana. No API keys.","url":"https://readx.sh/api/%7Bname%7D/relations","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"required":{"type":"string"},"properties":{"type":"string"}}},"responseSchema":{"type":"json","example":{"code":0,"data":{"canDm":false,"muting":false,"source":"jack","target":"elonmusk","blocking":false,"blockedBy":false,"sourceFollowsTarget":true,"targetFollowsSource":false}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_1FK8Qe0JYXeHhEDxlaE3M","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the bidirectional relationship status between two X/Twitter users, including follow, block, mute, and DM permission states.","exampleAgentPrompt":"Check whether the Twitter account 'jack' follows 'elonmusk' and if elonmusk follows back — also tell me if either of them is blocking or muting the other.","exampleUseCases":[{"title":"Mutual follow check between accounts","prompt":"Do @naval and @pmarca follow each other on X? I want to know if it's mutual or one-sided."},{"title":"Block detection for brand monitoring","prompt":"Check if the Twitter account @competitor_brand is blocking our company account @mybrand — I need to know if they've blocked us."},{"title":"DM eligibility check before outreach","prompt":"Before I reach out, can you check if @influencer123 follows @mybrand and whether they'd be able to receive a DM from us?"}],"resultDescription":"A JSON object with a 'data' field containing: source and target usernames, sourceFollowsTarget (boolean), targetFollowsSource (boolean), blocking (boolean), blockedBy (boolean), muting (boolean), and canDm (boolean). Also includes a top-level code field (0 = success).","failureModes":["Unknown or suspended username returns an error or empty data","Rate limiting or upstream X API unavailability causes a failed response","Incorrect or misspelled username in the path yields a not-found error","Payment failure (insufficient USDC balance) prevents the request from completing via x402"],"whenToPreferThis":"Choose this endpoint when you need to programmatically verify the follow/block/mute relationship between two specific X/Twitter users without managing X API keys. Ideal for social graph analysis, outreach eligibility checks, and mutual-follow detection. Prefer over the X official API when you want keyless micropayment access via USDC on Base or Solana.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T06:47:05.583Z","isFirstParty":false}