{"uid":"cap_ZGRAec101EIwEBoOYs_mb","slug":"twit-sh-get-twitter-x-user-following-list-3f55df59","name":"twit.sh – Get Twitter/X User Following List","description":"Real-time Twitter/X data for AI agents. No sign-up, no API keys. Pay per request in USDC on Base via x402. Fully autonomous.","url":"https://twit.sh/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"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["id"],"properties":{"id":{"type":"string","description":"Numeric Twitter user ID"},"next_token":{"type":"string","description":"Pagination cursor from previous response"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"data":[{"id":"9253672","name":"Hal Finney","username":"halfin","verified":false,"description":"Running bitcoin.","public_metrics":{"like_count":300,"tweet_count":600,"followers_count":134000,"following_count":200}}],"meta":{"next_token":"abc123"}}},"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_uV6ranZSRB9X63ztmL6l_","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 accounts that a given Twitter/X user is following, including profile and public metrics for each account.","exampleAgentPrompt":"Pull the full list of accounts that Twitter user ID 9253672 (Hal Finney) is following — I want their usernames, bios, and follower counts, and page through all results if there are more than one page.","exampleUseCases":[{"title":"Influencer network mapping","prompt":"Give me the list of everyone that Twitter user ID 44196397 (Elon Musk) is currently following, with their usernames and follower counts, so I can map out his network."},{"title":"Competitor audience research","prompt":"I want to see who our competitor's Twitter account (user ID 783214) follows — fetch their following list with bios and public metrics so I can spot partnership patterns."},{"title":"Crypto community graph analysis","prompt":"Fetch all the accounts that Twitter user ID 9253672 follows and include their follower counts — I'm building a graph of early Bitcoin community connections."}],"resultDescription":"A JSON array of user objects under 'data', each containing the user's numeric ID, display name, username, verified status, bio description, and public metrics (like_count, tweet_count, followers_count, following_count). A 'meta' object with a next_token is included when additional pages exist, enabling pagination through the full following list.","failureModes":["Invalid or non-existent user ID returns an empty data array or 404-equivalent error","Exhausted or invalid next_token causes pagination to fail or restart from the beginning","Payment failure (insufficient USDC or x402 issue) results in a 402 Payment Required response","Rate limiting or upstream Twitter/X API throttling may return a 429 or service-unavailable error","Private/protected accounts may return an empty or restricted following list"],"whenToPreferThis":"Use this endpoint when you need the following list of a specific Twitter/X user by numeric ID without setting up Twitter API credentials or OAuth. Ideal for autonomous AI agents that need real-time social graph data and can pay per-request in USDC on Base. Prefer this over the official Twitter API when you want zero-setup access or are operating in an agent context that supports x402 micropayments.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:32:52.814Z","isFirstParty":false}