{"uid":"cap_ACdRxZHWdEiRtI8brW6I_","slug":"x-twitter-user-profile-lookup-by-username-1216206a","name":"X (Twitter) User Profile Lookup by Username","description":"Resolves an X handle to a public profile: id, username, display name, bio, verification fields, created_at, followers, following, tweet count, and listed count. Same read-only X API v2 user-by-username backend as x-username. Use it as an X users by username API, Twitter user profile lookup, or handle to public profile API.","url":"https://x402.agentutility.ai/users-by-username?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"required":["username"],"properties":{"username":{"type":"string","description":"X/Twitter handle, with or without @, e.g. 'bankrbot'."}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"mode":{"type":"string"},"user":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"username":{"type":"string"},"public_metrics":{"type":"object","properties":{"followers_count":{"type":"integer"}}}}},"source":{"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"mode":"user","user":{"id":"99","name":"Bankr","username":"bankrbot","public_metrics":{"followers_count":1234}},"source":"X API v2 user lookup"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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_vjKnN_x73zONaK2rhbNEK","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Resolves an X (Twitter) handle to a full public user profile including id, display name, bio, verification status, follower counts, and account metadata.","exampleAgentPrompt":"Can you look up the public profile for the X account @sama — I want to see their display name, bio, follower count, and when the account was created?","exampleUseCases":[{"title":"Verify influencer account before outreach","prompt":"Before we run that influencer campaign, can you pull up the public profile for @MrBeast on X — I want to confirm their follower count, verification status, and bio to make sure it's the right account?"},{"title":"Enrich a list of X handles with profile data","prompt":"I have a list of startup founders' X handles — can you grab the public profile info for @sama, including their user ID, follower count, following count, and tweet count?"},{"title":"Research a competitor's social presence","prompt":"Can you look up the X profile for @OpenAI — I need their display name, bio description, follower count, and account creation date for a competitive analysis report?"}],"resultDescription":"Returns the full public X (Twitter) user profile for the given username, including numeric user ID, username, display name, bio text, verification fields, account creation timestamp, follower count, following count, total tweet count, and listed count.","failureModes":["Username not found — account may not exist or may have been suspended","Rate limit exceeded on the underlying X API v2","Invalid or malformed username input","Account is suspended or deactivated — profile not returned","Payment failure via x402 USDC — call not executed"],"whenToPreferThis":"Use this endpoint when you need to resolve an X handle to a structured public profile object — especially when you need the numeric user ID, follower/following counts, or verification status. Prefer this over scraping or manual lookup for agent workflows that need reliable, structured data at $0.005 USDC per call with USDC settlement on Base.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-19T06:40:09.331Z","isFirstParty":false,"canonicalSlug":"x-twitter-user-profile-lookup-by-username-1216206a"}