{"uid":"cap_MPdSCqm0BYoxSozoos_JC","slug":"twit-sh-twitter-x-user-lookup-by-numeric-id-349b6602","name":"twit.sh — Twitter/X User Lookup by Numeric ID","description":"Real-time Twitter/X data for AI agents. No sign-up, no API keys. Pay per request in USDC on Base via x402. Fully autonomous.","url":"https://twit.sh/users/by/id","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":["id"],"properties":{"id":{"type":"string","description":"Numeric Twitter user ID"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"data":{"id":"9253672","name":"Hal Finney","username":"halfin","verified":false,"description":"Running bitcoin.","public_metrics":{"like_count":300,"tweet_count":600,"followers_count":134000,"following_count":200}}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_BikYiEd24CKOmhsSiQgLP","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches real-time Twitter/X user profile data (name, username, bio, follower count, and other public metrics) given a numeric Twitter user ID.","exampleAgentPrompt":"Can you look up the Twitter/X profile for user ID 9253672 — I want to see their username, bio, and follower count?","exampleUseCases":[{"title":"Resolve anonymous Twitter ID to profile","prompt":"I have a numeric Twitter user ID — 9253672 — can you tell me who that is, what their handle is, and how many followers they have?"},{"title":"Enrich influencer list with profile data","prompt":"I have a list of Twitter user IDs for influencers we want to track. Can you pull the display name, username, and follower count for user ID 44196397?"},{"title":"Monitor account growth over time","prompt":"Pull the current follower count and tweet count for Twitter user ID 783214 so I can log it as today's snapshot for our growth tracking sheet."}],"resultDescription":"Returns a JSON object with the user's numeric ID, display name, username, verified status, bio/description, and public metrics including follower count, following count, tweet count, and like count.","failureModes":["Invalid or non-numeric ID returns an error or empty data response","Suspended or deactivated accounts may return no data","Payment failure via x402/USDC on Base will block the request","Rate limiting may occur under high request volume","Private or restricted accounts may return limited public data"],"whenToPreferThis":"Choose this endpoint when you have a numeric Twitter/X user ID and need real-time profile data without managing Twitter API keys or OAuth. It is ideal for fully autonomous agents that can pay per request in USDC on Base via x402, especially when you need to resolve IDs to usernames or retrieve current follower/engagement metrics programmatically without sign-up friction.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:36:32.626Z","isFirstParty":false}