{"uid":"cap_cdlDLNjFMFZe9fDCm09Sm","slug":"payweave-twitter-follower-ids-lookup-b12af42e","name":"PayWeave Twitter – Follower IDs Lookup","description":"X/Twitter data — tweets, users, communities, lists, articles, and trends.","url":"https://twitter.payweave.services/users/followers/ids","method":"GET","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":{"anyOf":[{"not":{}},{"type":"object","required":["username"],"properties":{"count":{"type":"integer","maximum":5000,"minimum":50,"description":"IDs per page, 50-5000 (default 5000). Price scales with this value: 0.45-2 credits/ID depending on tier (4000-5000=0.45cr, 200-3999=1cr, 50-199=2cr)."},"username":{"type":"string","minLength":1,"description":"X handle / screen name (without @), e.g. elonmusk."},"next_token":{"type":"string","description":"Pagination cursor from a previous response `next_cursor`. Omit for the first page."}},"additionalProperties":false}]},"type":{"type":"string","const":"http"},"method":{"type":"string","const":"GET"},"bodyType":{"type":"string","const":"json"}},"additionalProperties":false},"output":{"type":"object","required":["example"],"properties":{"example":{"type":"object","properties":{"ids":{"type":"array","items":{"type":"string"},"description":"Array of numeric follower ID strings."},"next_cursor":{"type":"string","description":"Cursor to pass as `next_token` for the next page."},"has_next_page":{"type":"boolean","description":"True when more pages are available."}},"description":"Follower-ID list JSON forwarded verbatim from twitterapi.io.","additionalProperties":true}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.039825","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.039825/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.039825","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.039825","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_bUM4b6iN1hI97ZaU3Qd-Q","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.039825","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 numeric Twitter/X follower IDs for a given username","exampleAgentPrompt":"Can you fetch the follower IDs for the Twitter account @naval — grab up to 5000 per page and give me the first page?","exampleUseCases":[{"title":"Influencer audience size audit","prompt":"Get me the follower IDs for @MrBeast on Twitter — I want 5000 per page so I can measure his audience reach."},{"title":"Competitor follower analysis","prompt":"Pull the follower IDs for @OpenAI on X so I can see who's following them and compare against our own follower base."},{"title":"Community growth monitoring","prompt":"Fetch the first page of follower IDs for @elonmusk with 200 IDs per page — I want to keep tracking new followers over time."}],"resultDescription":"Returns a JSON object containing an array of numeric follower ID strings ('ids'), a 'next_cursor' string for pagination, and a 'has_next_page' boolean indicating whether more results are available. The response is forwarded verbatim from twitterapi.io.","failureModes":["Invalid or non-existent username returns an error or empty list","Missing required 'username' field causes a schema validation failure","Count value outside 50–5000 range is rejected","Expired or invalid next_token cursor returns a pagination error","Rate limits or upstream twitterapi.io outages may cause 5xx errors","Payment failure (insufficient USDC) blocks the call with a 402 response"],"whenToPreferThis":"Choose this endpoint when you need raw numeric follower IDs for a Twitter/X account and plan to paginate through large follower lists. It is well-suited for bulk audience analysis, follower graph construction, or cross-referencing follower sets. Prefer this over profile-detail endpoints when you only need IDs rather than full user objects, as it is cheaper and faster for high-volume enumeration.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:49:05.273Z","isFirstParty":false}