{"uid":"cap_0ZMjIynPE1UtNZtVILbgt","slug":"x402-twit-sh-bcc52ada","name":"x402.twit.sh Twitter User Profile Lookup by Username","description":"Look up a Twitter/X user profile by their screen name. Returns full profile data including id, name, username, bio, follower count, following count, tweet count, verification status, and profile image URL. Query param: username (string, required) - Twitter screen name without @, e.g. GET /users/by/username?username=elonmusk. Returns X v2 API-compatible JSON.","url":"https://x402.twit.sh/users/by/username?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":["username"],"properties":{"username":{"type":"string","description":"Twitter screen name without @"}}}},"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":{"username":"twitter"}}},"response":{"data":{"id":"1683696495198089217","name":"Twitter","entities":{"description":{}},"location":"","username":"twitter","verified":false,"protected":true,"created_at":"2023-07-25T04:31:50.000Z","description":"This account is no longer active. Follow @x for updates.","public_metrics":{"like_count":0,"media_count":0,"tweet_count":0,"listed_count":0,"followers_count":0,"following_count":0},"profile_image_url":"https://pbs.twimg.com/profile_images/1683698521600565248/_R1r5HsQ_normal.jpg","profile_banner_url":"","is_identity_verified":false}}},"exampleRequest":{"username":"twitter"},"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":2,"rating":{"score":"0.96","successRate":"1.00","reviews":2,"stars":"4.8","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_R8vZEGkZRjCwPs7IAQ8ll","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 Twitter/X user profile by screen name, returning full profile data including bio, follower/following counts, tweet count, verification status, and profile image URL.","exampleAgentPrompt":"Can you pull up the Twitter profile for elonmusk — I want their follower count, bio, and whether they're verified?","exampleUseCases":null,"resultDescription":"Returns a JSON object with the user's numeric ID, display name, username, bio/description, location, follower count, following count, tweet count, listed count, like count, media count, profile image URL, profile banner URL, verified status, identity verification status, protected status, and account creation date — all in X v2 API-compatible format.","failureModes":["Username not found — returns 404 or empty data if the screen name does not exist","Username missing from query params — returns validation error","Rate limit exceeded — too many calls in a short window","User account suspended or deactivated — may return empty or error response","Payment failure — x402 payment not completed, returns 402 Payment Required"],"whenToPreferThis":"Use this endpoint when you need to resolve a Twitter/X screen name to full profile metadata, including numeric user ID, follower stats, and bio, without direct Twitter API credentials. Prefer this over search-based endpoints when the exact username is already known. Useful for profile enrichment, identity resolution, and social analytics workflows.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":6,"lastUsedAt":"2026-07-17T12:31:13.743Z","lastSuccessfullyRanAt":"2026-07-17T12:31:13.743Z","lastHealthCheckAt":"2026-10-11T00:39:53.361Z","isFirstParty":false,"canonicalSlug":"x402-twit-sh-bcc52ada"}