{"uid":"cap_A1us9X-0iwQIYGPqmeqRK","slug":"twitter-x-user-following-list-a775c7df","name":"Twitter/X User Following List","description":"User following","url":"https://twitter.surf.cascade.fyi/api/v1/twitter/users/:ref/following?utm_source=zero.xyz","method":"POST","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":{"type":"object","properties":{"cursor":{"type":"string","description":"Pagination cursor"},"page_size":{"type":"integer","default":200,"maximum":200,"minimum":20,"description":"Number of users per page"}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"},"pathParams":{"type":"object"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"meta":{"type":"object","required":["result_count"],"properties":{"next_cursor":{"type":"string"},"result_count":{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991},"has_next_page":{"type":"boolean"}}}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.004","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.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Dlhy8S0Pts1VPmMlOk9Bz","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves a paginated list of accounts that a specified Twitter/X user is following","exampleAgentPrompt":"Can you pull the list of accounts that @elonmusk follows on Twitter — get me the first 200 and include the cursor so I can page through the rest?","exampleUseCases":[{"title":"Influencer network mapping","prompt":"Fetch the accounts that @naval follows on Twitter — give me up to 200 per page and keep going until you've got the full list using the pagination cursor."},{"title":"Competitor audience research","prompt":"I want to see who the @OpenAI Twitter account is following — pull the first page of 200 accounts and give me the cursor so I can continue paging."},{"title":"Social graph monitoring for a brand","prompt":"Check who @Coinbase is following on X right now — I need the full following list, starting with 200 users per page."}],"resultDescription":"Returns a paginated array of user objects representing accounts the specified user follows, along with metadata including total result count, a next_cursor string for fetching the next page, and a has_next_page boolean indicating whether more results exist.","failureModes":["Invalid or non-existent user ref returns empty data or error","Rate limiting from the underlying Twitter API causing request failures","Invalid cursor value causing pagination errors","page_size outside the 20-200 range causing validation errors","Private/protected accounts may not expose following list","API payment failure for x402 protocol"],"whenToPreferThis":"Use this endpoint when you need to programmatically retrieve the following list of any public Twitter/X account, especially when you need pagination support for accounts with large following counts. Prefer this over scraping or manual lookup when you need structured data with metadata and cursor-based pagination.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-18T12:30:14.186Z","isFirstParty":false,"canonicalSlug":"twitter-surf-cascade-fyi-d3aab6f8"}