{"uid":"cap_FPN8LWzdlgue9Xls_LkHE","slug":"readx-get-following-list-web-57f76e67","name":"ReadX — Get Following List (Web)","description":"Accounts a user follows as shown on the web (~70 per page, capped at ~800; paginate with cursor until has_more is false). Example: GET /api/jack/following_web","url":"https://readx.sh/api/:name/following_web","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"pathParams":{"type":"object"},"queryParams":{"type":"object","required":["name"],"properties":{"name":{"type":"string","pattern":"^[A-Za-z0-9_]+$","minLength":1,"description":"X handle without the leading @ (alphanumeric and underscore)."},"cursor":{"type":"string","description":"Pagination cursor from a previous response's pagination.next_cursor (the conversation endpoint at /api/{name}/tweets/{id} instead takes its own nested reply cursor — see that endpoint)."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"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_Ar7p3dezOCrpQl7HgaaF-","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 paginated list of X/Twitter accounts a given user follows, as surfaced on the web (~70 per page, capped at ~800 total).","exampleAgentPrompt":"Can you pull up the full list of accounts that jack follows on X, paginating through all the pages?","exampleUseCases":[{"title":"Influencer network mapping","prompt":"I want to know every account that @elonmusk follows on X — can you fetch the full following list and paginate through all pages until you have them all?"},{"title":"Competitive intelligence on brand follows","prompt":"Pull up all the accounts that @Nike follows on X so I can see which other brands, athletes, or influencers they're keeping tabs on."},{"title":"Social graph research for a given user","prompt":"I'm studying how journalists network on X — can you get the complete following list for @nytimes so I can analyze who they follow?"}],"resultDescription":"A paginated JSON response containing a list of X/Twitter account objects that the specified user follows (approximately 70 per page, capped at ~800 total). Each page includes a pagination object with a next_cursor field and a has_more boolean to drive iteration.","failureModes":["Unknown or suspended X handle returns an error or empty result","Private/protected accounts may not expose following list","Pagination cursor mismatch or expired cursor returns an error","Rate limits or payment failures (HTTP 402) halt further calls","Account with zero following returns empty list with has_more=false"],"whenToPreferThis":"Use this endpoint when you need to programmatically retrieve the accounts a specific X/Twitter user follows, especially for social graph analysis, influence mapping, or competitor research. Prefer it over scraping X directly since it provides structured JSON with built-in pagination and a predictable pay-per-call cost model. It is capped at ~800 accounts, so for accounts following more than that, expect truncation.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:46:33.195Z","isFirstParty":false}