{"uid":"cap_nsdeuw83UuQxadpPyARe0","slug":"x-data-gateway-get-user-followers-29448b9b","name":"X Data Gateway – Get User Followers","description":"One page of followers by numeric user ID. e.g. GET /users/followers?id=44196397","url":"https://x-data-gateway.annushka1190.workers.dev/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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["id"],"properties":{"id":{"type":"string","description":"Numeric X user ID"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"data":{}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.008","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.008/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.008","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.008","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_4KqYe_lOEMqKMcIsLbwQ3","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.008","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches a paginated list of followers for a given Twitter/X user by their numeric user ID, returning follower IDs and usernames in real-time.","exampleAgentPrompt":"Can you pull the list of followers for X user ID 44196397 and tell me their usernames?","exampleUseCases":[{"title":"Audience research for a brand account","prompt":"I need to see who's following the Twitter account with user ID 783214 — can you fetch their follower list and show me the usernames?"},{"title":"Competitor follower analysis","prompt":"Pull the followers of the X account with user ID 6253282 so I can analyze who their audience is."},{"title":"Influencer vetting for a campaign","prompt":"Can you get the follower list for X user ID 44196397? I want to see how many followers they have and who some of them are before we partner with them."}],"resultDescription":"Returns a JSON object with a `data` array of follower objects (each containing `id` and `username`) and a `meta` object with a `next_token` for pagination through additional followers.","failureModes":["Invalid or non-numeric user ID returns an error response","Private/protected accounts may return empty or restricted follower data","Payment failure (insufficient USDC) blocks the request with a 402 response","Rate limits on the underlying Twitter/X API may cause temporary unavailability","User ID that does not exist returns an empty data array or 404-style error"],"whenToPreferThis":"Use this endpoint when you need real-time Twitter/X follower data without setting up a Twitter developer account or managing API keys — especially for AI agents that can pay per request in USDC via x402. Ideal for one-off lookups, agent workflows, or situations where provisioning OAuth credentials is impractical.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:33:17.169Z","isFirstParty":false}