{"uid":"cap_f_3Vdvj4fBqwG0s5UdcE5","slug":"twit-sh-get-twitter-x-user-followers-f5540889","name":"twit.sh — Get Twitter/X User 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/users/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 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_-kuTcJGeMxi4O06EaFVuv","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":"Retrieves a paginated list of followers for a given Twitter/X user ID, returning profile and metrics data for each follower","exampleAgentPrompt":"Pull the followers list for Twitter user ID 783214 — I want to see their usernames, descriptions, and follower counts, and page through all of them.","exampleUseCases":[{"title":"Audience analysis for influencer research","prompt":"Get me the followers of Twitter user ID 44196397 so I can analyze who follows them — I need their usernames, bios, and follower counts."},{"title":"Social graph mapping for an agent","prompt":"Fetch the followers of Twitter user 783214 and keep paginating using the next_token until I have at least the first two pages of results."},{"title":"Competitor audience intelligence","prompt":"I want to see who follows our competitor's Twitter account — their user ID is 6253282. Pull the follower list with their public metrics like how many followers each person has."}],"resultDescription":"Returns a JSON array of follower objects, each containing the follower's numeric ID, display name, username, verified status, bio description, and public metrics (like count, tweet count, followers count, following count). Also includes a meta object with a next_token for paginating to the next page of results.","failureModes":["Invalid or non-numeric user ID returns an error","User account is private or suspended — no followers returned","Expired or invalid next_token causes pagination failure","Rate limits or payment failures (USDC/x402) may block requests","User has zero followers — empty data array returned"],"whenToPreferThis":"Choose this endpoint when you need real-time Twitter/X follower data without managing Twitter API credentials or OAuth. It is ideal for autonomous AI agents that need to pay per request via USDC on Base (x402 protocol) with no prior sign-up. Prefer it over direct Twitter API access when credential management is undesirable, or when building fully autonomous workflows that self-fund via crypto micropayments.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:30:40.807Z","isFirstParty":false}