{"uid":"cap_x3dHdIrWx9qC-0UOOpNNZ","slug":"readx-twitter-x-followers-web-api-d779fd24","name":"ReadX — Twitter/X Followers Web 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/followers_web","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"required":{"type":"string"},"properties":{"type":"string"}}},"responseSchema":{"type":"json","example":{"code":0,"data":{"users":[{"id":"12","bio":"","likes":0,"media":0,"banner":"","tweets":30000,"userPic":"","website":"","fullname":"jack","joinDate":1142974214,"location":"","username":"jack","followers":6500000,"following":4000,"protected":false,"suspended":false,"pinnedTweet":"0","verifiedType":"Blue"}],"total_count":70},"pagination":{"has_more":true,"next_cursor":"DAABCgABG...cursor"}}},"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_lZSbMiQKTegkc4ivdqiF3","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 a paginated list of followers for a given Twitter/X username, with full profile details for each follower","exampleAgentPrompt":"Can you pull the followers list for the Twitter account 'jack' — I want to see who's following him, with their bios and follower counts?","exampleUseCases":[{"title":"Influencer audience analysis","prompt":"Get me the followers of @elonmusk on Twitter so I can see what kinds of accounts are in his audience — include their bios and follower counts."},{"title":"Brand competitor monitoring","prompt":"I want to see who's following our competitor's Twitter account @Nike — can you fetch their followers list page by page so I can analyze the audience?"},{"title":"Social graph research tool","prompt":"Pull the full followers list for the Twitter user 'sama' and keep paginating until you have all of them — I need their usernames, bios, and follower counts for a research project."}],"resultDescription":"A JSON object containing an array of follower user profiles (each with id, username, fullname, bio, location, follower/following counts, tweet count, profile picture, banner, website, join date, verified type, protected/suspended status, and pinned tweet), a total_count, and pagination metadata (has_more boolean and next_cursor string for fetching subsequent pages, ~200 users per page).","failureModes":["Invalid or non-existent username returns error code","Payment not included or insufficient USDC results in 402 Payment Required","Rate limiting or upstream X/Twitter API restrictions may cause failures","Protected account followers may not be accessible","Expired or invalid pagination cursor returns error","Network timeout on large follower lists"],"whenToPreferThis":"Choose this endpoint when you need structured follower data for a Twitter/X account without managing Twitter API keys or OAuth credentials. It is ideal for agents that need to enumerate followers programmatically, build social graphs, or analyze audience composition. Prefer it over the Twitter official API when you want pay-per-call micropayment pricing (no monthly subscription), or when Twitter API tier limits are a constraint. Use the verified-followers sibling endpoint instead if you only want verified followers.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T06:30:35.218Z","isFirstParty":false}