{"uid":"cap_njPyJhoKvwHtSCtwCi46r","slug":"twitter-x-user-profile-lookup-by-username-f3cc8675","name":"Twitter/X 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://api.aidress.ai/pay/agent_x402_twit_sh","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":null,"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_t862WOAmsFI7NKZsmTedS","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 a Twitter/X user's full profile data by screen name, returning id, bio, follower/following/tweet counts, verification status, and profile image URL.","exampleAgentPrompt":"Can you pull up the full Twitter profile for the account 'elonmusk' — I need their follower count, bio, tweet count, and whether they're verified?","exampleUseCases":[{"title":"Verify influencer credibility for partnerships","prompt":"I'm evaluating potential brand ambassadors for our campaign. Can you look up the Twitter profiles for 'david_perell', 'naval', and 'theallinpodcast' and tell me their follower counts and verification status so I can compare their reach?"},{"title":"Build contact list with social proof metrics","prompt":"We're compiling a list of industry experts to reach out to. Can you pull the profile info for these Twitter handles: 'balajis', 'paulg', and 'sama'? I need their bios, follower counts, and profile picture URLs to include in our outreach materials."},{"title":"Detect fake accounts in user submissions","prompt":"Our platform lets users submit Twitter handles they want to connect with. Can you quickly verify these accounts are real by fetching their profiles for 'satoshi', 'vitalik', and 'thishandledoesntexist'? Just confirm they exist, show me their tweet counts, and flag any that look suspicious."}],"resultDescription":"Returns an X v2 API-compatible JSON object containing the user's numeric id, display name, username, biography text, follower count, following count, total tweet count, verification status (boolean), and profile image URL.","failureModes":["Username not found — returns 404 or empty data if the screen name does not exist","Missing required username query param — returns 400 bad request","Rate limit or upstream Twitter API failure — returns 5xx error","Suspended or deactivated account — may return empty or error response","Typo in username — returns no results rather than fuzzy match"],"whenToPreferThis":"Choose this endpoint when you need structured Twitter/X profile metadata for a known username and want X v2 API-compatible JSON without managing Twitter OAuth credentials yourself. Ideal for enriching user data pipelines, verifying account existence, or pulling social proof metrics. Costs only $0.005 USDC per call via x402 micropayment.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:43:45.686Z","isFirstParty":false}