{"uid":"cap_SlMamxvKfIxYw7Iy8gc7C","slug":"botsmith-x-follower-sample-53f948a6","name":"botsmith X Follower Sample","description":"X Follower Sample ($0.01/call): Sample an X (Twitter) account's audience: its 40 newest followers with full profiles (bio, follower counts, account age, verification), how many of them are verified (checked against the account's verified-follower list, not X's dead legacy flag) and that share, plus the account's total follower count. No X account or API key needed.","url":"https://x402.botsmith.dev/x/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":["handle"],"properties":{"handle":{"type":"string","pattern":"^@?[A-Za-z0-9_]{1,15}$","description":"X handle, with or without the leading @"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["handle","totalFollowers","sampleSize","verifiedInSample","verifiedShare","verifiedIsLowerBound","followers"],"properties":{"handle":{"type":"string"},"followers":{"type":"array","items":{"type":"object","required":["handle","id","name","bio","url","location","profileImage","verified","followers","following","tweetCount","createdAt","accountAgeDays"],"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}]},"bio":{"anyOf":[{"type":"string"},{"type":"null"}]},"url":{"anyOf":[{"type":"string"},{"type":"null"}]},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"handle":{"type":"string"},"location":{"anyOf":[{"type":"string"},{"type":"null"}]},"verified":{"type":"object","required":["blue","type"],"properties":{"blue":{"type":"boolean"},"type":{"anyOf":[{"type":"string"},{"type":"null"}]}},"additionalProperties":false},"createdAt":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ISO 8601 account creation time"},"followers":{"anyOf":[{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991},{"type":"null"}]},"following":{"anyOf":[{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991},{"type":"null"}]},"tweetCount":{"anyOf":[{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991},{"type":"null"}]},"profileImage":{"anyOf":[{"type":"string"},{"type":"null"}]},"accountAgeDays":{"anyOf":[{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991},{"type":"null"}]}},"additionalProperties":false},"description":"Newest followers first"},"sampleSize":{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991},"verifiedShare":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"verifiedInSample / sampleSize"},"totalFollowers":{"anyOf":[{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991},{"type":"null"}]},"verifiedInSample":{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991,"description":"Followers in this sample with a verified badge"},"verifiedIsLowerBound":{"type":"boolean","description":"True when the sample may hold more verified followers than counted"}},"additionalProperties":false}}}}},"responseSchema":null,"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_U3HXaXru41SC6DsG4xaO1","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 the 40 newest followers of any X (Twitter) account with full profiles, verified-follower counts, and total follower stats — no X account or API key required.","exampleAgentPrompt":"Can you pull a follower sample for @elonmusk on X — I want to see the 40 newest followers with their bios, follower counts, account ages, and what share of them are verified?","exampleUseCases":[{"title":"Influencer audience quality check","prompt":"Before we pay for a sponsored post with @cryptoinfluencer99, can you sample their X followers and tell me how many are verified and what their typical follower counts and account ages look like?"},{"title":"Competitor audience research","prompt":"I want to understand who follows @OpenAI on X — pull a sample of their newest 40 followers with full profiles and show me the verified follower percentage."},{"title":"Bot or fake follower detection","prompt":"Can you sample the followers of @suspicious_brand on X and tell me what share are verified, how old the accounts are, and what their follower-to-following ratios look like?"}],"resultDescription":"Returns a JSON object with the target account's handle, total follower count, sample size (up to 40), count of verified followers in the sample, verified share percentage, a flag indicating if the verified count is a lower bound, and an array of up to 40 follower objects each containing handle, ID, display name, bio, URL, location, profile image URL, verification status (blue and type), follower count, following count, tweet count, account creation timestamp, and account age in days.","failureModes":["Invalid or non-existent X handle returns an error","Handle with no followers returns empty followers array","Rate limiting or X platform unavailability may cause failures","Truncated or missing profile fields when X does not expose them","Payment failure if USDC balance is insufficient (x402 protocol)"],"whenToPreferThis":"Choose this endpoint when you need a quick, no-credentials audience sample for any public X account — especially useful for influencer vetting, audience quality audits, or bot detection without needing an X developer account or API key. Prefer it over the full X Account Dossier ($0.05) when you specifically need follower-level profile data rather than tweet history or account-level analytics.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:38:59.365Z","isFirstParty":false,"canonicalSlug":"botsmith-x-follower-sample-53f948a6"}