{"uid":"cap_GGk2fHLegTlKc4thhJ6Nw","slug":"readx-get-user-id-d21f0fcf","name":"ReadX Get User ID","description":"Resolve an @handle to its numeric user id. Example: GET /api/tools/get_user_id?username=jack","url":"https://readx.sh/api/tools/get_user_id","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"required":{"type":"string"},"properties":{"type":"string"}}},"responseSchema":{"type":"json","example":{"code":0,"data":{"id":"12"}}},"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_qFeAFp88lFIwBoqTcRRBa","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 an X/Twitter username to its numeric user ID via a pay-per-call micropayment API","exampleAgentPrompt":"What's the numeric Twitter/X user ID for the account @elonmusk? I need the actual number, not just the handle.","exampleUseCases":null,"resultDescription":"Returns a JSON object with a status code and a data object containing the numeric user ID (e.g. {\"code\":0,\"data\":{\"id\":\"12\"}}) for the requested X/Twitter username.","failureModes":["Username does not exist — likely returns a non-zero error code","Payment fails or insufficient USDC balance — x402 payment error","Rate limiting or upstream X API unavailability — service error response","Malformed username input — validation error","Suspended or deactivated account — may return error or empty data"],"whenToPreferThis":"Use this endpoint when you need to resolve an X/Twitter screen name to a numeric user ID without managing Twitter API keys, and when you want to pay per call with USDC micropayments via x402 on Base or Solana. Prefer this over direct Twitter API access when you lack API credentials or want a serverless, keyless integration for occasional lookups.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:44:43.082Z","isFirstParty":false}