{"uid":"cap_Iy_AWmqLsr5KUDopNk5kf","slug":"twit-sh-x-twitter-list-followers-a8f0139c","name":"twit.sh — X/Twitter List Followers","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/lists/followers","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":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_tg0YJeClwQ4OVwXXIpS9_","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 user profiles who follow a specified Twitter/X list, including account metrics","exampleAgentPrompt":"Can you pull the list of followers for X list ID 1234567890 and show me their usernames, bios, and follower counts?","exampleUseCases":[{"title":"Audience research for a Twitter list","prompt":"Fetch all the accounts that follow Twitter list 1234567890 and give me their usernames, bios, and follower counts so I can understand who's engaging with that community."},{"title":"Paginated follower crawl for a niche list","prompt":"Get the followers of X list 99887766 — start from pagination token abc123 so we continue where we left off last time."},{"title":"Influencer vetting from a curated list","prompt":"Look up who follows the X list with ID 5544332211 and flag any accounts with more than 50,000 followers so I can identify potential influencers in that space."}],"resultDescription":"A JSON object containing an array of user profiles (id, name, username, verified, description, public_metrics with follower/following/tweet/like counts) for followers of the specified list, plus a meta object with a next_token for pagination.","failureModes":["Invalid or non-existent list ID returns an empty data array or 404-equivalent error","Missing required 'id' query parameter causes a validation error","Expired or invalid next_token causes pagination to fail or restart","Rate limiting or payment failure (insufficient USDC balance) returns a 402 Payment Required","Private or suspended lists may return no data or an authorization error"],"whenToPreferThis":"Choose this endpoint when you need autonomous, no-signup access to Twitter/X list follower data paid per-request in USDC via x402, particularly in agent workflows where managing OAuth credentials is impractical. Prefer it over the official Twitter API when you want micropayment-based access without rate-limit tiers or API key management.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:47:07.104Z","isFirstParty":false}