{"uid":"cap_ol8xcjtxkeO6eVAHJsZFq","slug":"readx-get-user-ids-0d4c4b58","name":"ReadX Get User IDs","description":"Resolve up to 20 @handles to numeric user ids (map; null on per-handle failure). Example: GET /api/tools/get_user_ids?usernames=jack,elonmusk","url":"https://readx.sh/api/tools/get_user_ids","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"required":{"type":"string"},"properties":{"type":"string"}}},"responseSchema":{"type":"json","example":{"code":0,"data":{"jack":"12","elonmusk":"44196397","thisuserdoesnotexistzzz":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_22d2zeQPkO0l1vNf84ZpW","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":"Resolves one or more X/Twitter usernames to their numeric user IDs in a single call","exampleAgentPrompt":"Look up the numeric Twitter user IDs for the usernames 'jack' and 'elonmusk' — I need the raw IDs to pass into another tool.","exampleUseCases":[{"title":"Resolving influencer handles before analytics","prompt":"I have a list of Twitter handles — jack, elonmusk, and naval — and I need their numeric user IDs before I can pull their timelines. Can you look up the IDs for all three?"},{"title":"Validating whether a Twitter account exists","prompt":"Can you check whether the Twitter account 'thisuserdoesnotexistzzz' exists by trying to resolve its user ID?"},{"title":"Enriching a CRM with Twitter IDs","prompt":"I have a spreadsheet of Twitter usernames for our leads and I need to add their numeric Twitter user IDs. Start with 'pmarca' and 'sama' — what are their IDs?"}],"resultDescription":"Returns a JSON object with a code (0 = success) and a data map where each requested username is a key whose value is either the numeric Twitter user ID string or null if the account does not exist.","failureModes":["Username does not exist — returned as null in the data map rather than an error","Payment failure or insufficient USDC balance — x402 payment rejected before the call completes","Malformed or empty username input — may return an error code","Rate limiting or temporary X/Twitter backend unavailability — may return a non-zero error code"],"whenToPreferThis":"Use this endpoint when you need to resolve Twitter/X usernames to numeric user IDs without obtaining official Twitter API credentials. It is especially useful for enriching datasets, validating account existence, or preparing IDs for downstream Twitter data calls. Prefer it over the official Twitter API when you want instant pay-per-call access with no key management overhead.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:45:31.914Z","isFirstParty":false}