{"uid":"cap_XrIqazvjvmQTlHbVT9nK5","slug":"x402-twit-sh-1af5a326","name":"x402.twit.sh List Followers","description":"Retrieves a list of Users who follow a specific Twitter/X List by its ID. Returns up to 20 user profiles per page with pagination support. Query params: id (string, required) - numeric List ID; next_token (string, optional) - pagination cursor, e.g. GET /lists/followers?id=84839422. Returns X v2 API-compatible JSON.","url":"https://x402.twit.sh/lists/followers?utm_source=zero.xyz","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/X List 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":{"request":{"input":{"type":"http","method":"GET","queryParams":{"id":"84839422"}}},"response":{"_truncated":true,"_originalSize":11447}},"exampleRequest":{"id":"84839422"},"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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_SCMZ2G22rFEEIuFrW_jcZ","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 Twitter/X user profiles who follow a specific List, identified by its numeric List ID.","exampleAgentPrompt":"Can you get me the followers of Twitter List ID 84839422? Pull the first page of up to 20 user profiles.","exampleUseCases":null,"resultDescription":"Returns an X v2 API-compatible JSON object containing up to 20 user profiles of people who follow the specified List, along with a next_token cursor for retrieving subsequent pages.","failureModes":["Missing or invalid List ID returns an error response","Non-numeric or malformed List ID may cause a 400 bad request","Private or deleted list may return 403 or 404","Invalid next_token causes pagination failure","Rate limiting or payment failure returns 402 payment required"],"whenToPreferThis":"Use this endpoint when you need to discover or enumerate users who follow a specific Twitter/X List by its numeric ID, especially for audience analysis, list auditing, or building follower graphs. Prefer over user-follower endpoints when the subject is a List entity rather than an individual user account.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-15T18:36:47.256Z","isFirstParty":false,"canonicalSlug":"x402-twit-sh-1af5a326"}