{"uid":"cap_cbL-As8vIdRcFf1MjSfex","slug":"x402-twit-sh-c91741a7","name":"x402.twit.sh Twitter User Profile Lookup by ID","description":"Look up a single Twitter/X user profile by their numeric user ID. Returns full profile data including id, name, username, bio, follower count, following count, tweet count, and verification status. Query param: id (string, required) - numeric Twitter user ID, e.g. GET /users/by/id?id=44196397. Returns X v2 API-compatible JSON.","url":"https://x402.twit.sh/users/by/id?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":["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":{"request":{"input":{"type":"http","method":"GET","queryParams":{"id":"123456789"}}},"response":{"data":{"id":"123456789","name":"Some Test User","entities":{"description":{}},"location":"","username":"some_test_user","verified":false,"protected":false,"created_at":"2010-03-16T04:34:34.000Z","description":"Oops","public_metrics":{"like_count":2,"media_count":0,"tweet_count":4,"listed_count":0,"followers_count":112,"following_count":3},"profile_image_url":"https://abs.twimg.com/sticky/default_profile_images/default_profile_normal.png","profile_banner_url":""}}},"exampleRequest":{"id":"123456789"},"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":1,"rating":{"score":"1.00","successRate":"1.00","reviews":1,"stars":"5.0","state":"rated"},"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_ptc5a22DXCaO_xqWyKVgf","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":"Look up a single Twitter/X user profile by their numeric user ID, returning full profile data including name, username, bio, follower count, following count, tweet count, and verification status.","exampleAgentPrompt":"Can you pull up the Twitter profile for user ID 44196397 — I want to see their username, bio, follower count, and whether they're verified?","exampleUseCases":null,"resultDescription":"A JSON object compatible with the X v2 API format containing the user's numeric ID, display name, username (handle), bio description, follower count, following count, total tweet count, and verification status.","failureModes":["Invalid or non-numeric user ID returns an error response","User ID does not exist on Twitter/X — returns 404 or empty result","Payment failure (insufficient USDC balance) results in 402 Payment Required","Rate limiting or upstream Twitter API errors may cause 5xx responses","Missing required 'id' query parameter returns a 400 Bad Request"],"whenToPreferThis":"Use this endpoint when you have a specific numeric Twitter user ID and need to resolve it to a full profile. Ideal for enriching datasets that contain user IDs but lack profile details, or when verifying account metadata such as follower counts or verification status. Prefer over search-based endpoints when the exact user ID is already known.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":50,"lastUsedAt":"2026-07-15T21:48:44.723Z","lastSuccessfullyRanAt":"2026-07-15T21:48:44.723Z","lastHealthCheckAt":"2026-10-31T00:31:05.160Z","isFirstParty":false,"canonicalSlug":"x402-twit-sh-c91741a7"}