{"uid":"cap_Ja17j0Cv5Q5wJJ8k0WT35","slug":"payweave-twitter-get-user-following-list-f08a8e9e","name":"PayWeave Twitter – Get User Following List","description":"X/Twitter data — tweets, users, communities, lists, articles, and trends.","url":"https://twitter.payweave.services/users/following","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":["username"],"properties":{"pageSize":{"type":"integer","maximum":200,"minimum":20,"description":"Results per page, 20-200 (default 200). Price scales with this value: 1-3 credits/item depending on tier (200=1cr, 100-199=2cr, 20-99=3cr)."},"username":{"type":"string","minLength":1,"description":"X handle / screen name (without @), e.g. elonmusk."},"next_token":{"type":"string","description":"Pagination cursor from a previous response `next_cursor`. Omit for the first page."}},"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":{"users":{"type":"array","items":{"type":"object","additionalProperties":{}},"description":"Array of user-profile objects."},"members":{"type":"array","items":{"type":"object","additionalProperties":{}},"description":"Array of user-profile objects."},"followers":{"type":"array","items":{"type":"object","additionalProperties":{}},"description":"Array of user-profile objects."},"followings":{"type":"array","items":{"type":"object","additionalProperties":{}},"description":"Array of user-profile objects."},"next_cursor":{"type":"string","description":"Cursor to pass as `next_token` for the next page."},"has_next_page":{"type":"boolean","description":"True when more pages are available."}},"description":"User list JSON forwarded verbatim from twitterapi.io.","additionalProperties":true}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.00354","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.00354/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.00354","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.00354","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_hX2DNPwJTNGGt6hlHoIHK","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.00354","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves a paginated list of Twitter/X accounts that a given user is following, proxied through twitterapi.io with per-call USDC micropayment.","exampleAgentPrompt":"Can you pull up the list of accounts that @naval is following on X — grab 200 per page so we get through it efficiently?","exampleUseCases":[{"title":"Influencer network mapping","prompt":"I want to see who @paulg follows on X — get me the full following list with 200 accounts per page so I can map out his network."},{"title":"Competitive intelligence on brand accounts","prompt":"Fetch the list of accounts that @Nike follows on Twitter so I can see which brands and athletes they're keeping tabs on."},{"title":"Audience research for a creator","prompt":"Who is @lexfridman following on X right now? Get me the first page of 100 followings so I can check if there are any notable scientists or researchers in there."}],"resultDescription":"Returns a JSON object containing an array of user-profile objects under the 'followings' key, each with standard X/Twitter profile fields (id, name, screen_name, bio, follower counts, etc.), along with a 'next_cursor' string for pagination and a 'has_next_page' boolean indicating whether more results exist.","failureModes":["Invalid or non-existent username returns an error or empty array","Rate limits from the upstream twitterapi.io may cause failures under high concurrency","Missing required 'username' field in request body returns a validation error","Invalid next_token / stale cursor may return an error or restart pagination","Private/protected accounts may return empty results if the account is not public","Insufficient USDC balance causes x402 payment failure before the request is proxied"],"whenToPreferThis":"Choose this endpoint when you need to retrieve the accounts a specific public Twitter/X user follows, especially in an agent context where pay-per-call micropayments (USDC via x402) are preferable to managing API keys and Twitter developer app credentials. It is well-suited for social graph analysis, influencer research, and audience intelligence tasks where you need paginated following data without setting up your own Twitter API access.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:50:05.800Z","isFirstParty":false}