{"uid":"cap_OC5VSMKKPaMoxcmXqiLoy","slug":"readx-search-users-api-d5b1ac0d","name":"ReadX Search Users API","description":"Search for users by query (paginate with cursor until has_more is false). Example: GET /api/search/users?q=jack","url":"https://readx.sh/api/search/users","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"required":{"type":"string"},"properties":{"type":"string"}}},"responseSchema":{"type":"json","example":{"code":0,"data":{"users":[{"id":"99","bio":"","likes":0,"media":0,"banner":"","tweets":30000,"userPic":"","website":"","fullname":"Someone","joinDate":1142974214,"location":"","username":"someone","followers":599,"following":307,"protected":false,"suspended":false,"pinnedTweet":"0","verifiedType":"Blue"}]},"pagination":{"has_more":true,"next_cursor":"DAABCgABG...cursor"}}},"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_ybG4-rTeppAaHtNOyq_eA","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":"Search for X/Twitter user accounts by keyword or query, returning profile data including follower counts, verification status, and profile URLs","exampleAgentPrompt":"Search X/Twitter for users matching 'AI researcher' and give me their usernames, follower counts, and whether they're verified — use ReadX and page through the results if there are more.","exampleUseCases":null,"resultDescription":"A JSON object containing an array of user profiles, each with fields: id, url, name, type, userName, followers, following, isVerified, isBlueVerified — plus a has_more boolean and a next_cursor string for pagination.","failureModes":["Payment not included or insufficient USDC — returns 402 Payment Required","Invalid or missing search query parameter — returns 400 Bad Request","Rate limit or quota exceeded — returns 429 Too Many Requests","No users found matching the query — returns empty users array with has_more: false","Invalid cursor token for pagination — may return 400 or empty results"],"whenToPreferThis":"Use this endpoint when you need to search X/Twitter for user accounts by keyword without managing API keys, prefer pay-per-call micropayments via x402 in USDC, and need structured JSON profile data including follower counts and Blue verification status. Prefer over official Twitter API when avoiding OAuth setup or when operating in a crypto-native agent pipeline.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:46:07.599Z","isFirstParty":false}