{"uid":"cap_okzBzcMfrY4iDZQesPpHL","slug":"agent402-x-user-profile-lookup-4f30c157","name":"Agent402 X User Profile Lookup","description":"Look up one X (Twitter) account by username: id, display name, bio, account creation date, verification status and type, location, link, protected flag, and public metrics (followers, following, tweet count, listed count).","url":"https://agent402.tools/api/x-user","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"username":{"type":"string","description":"X username, with or without the leading @ (1-15 chars)."}}},"responseSchema":{"type":"json","example":{"user":{"id":"574032254","url":"https://coinbase.com","name":"Coinbase","metrics":{"listed":9000,"tweets":19000,"followers":6400000,"following":250},"location":"Global","username":"coinbase","verified":true,"createdAt":"2012-05-07T23:46:41.000Z","protected":false,"profileUrl":"https://x.com/coinbase","description":"The future of money is here.","verifiedType":"business","profileImageUrl":"https://pbs.twimg.com/profile_images/.../normal.jpg"},"source":"x-api-v2","fetchedAt":"2026-08-20T14:10:00.000Z"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.015","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.015/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.015","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.015","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_60ApBDd8siTQLWRYU3fUE","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.015","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches a public X (Twitter) user profile by username, returning follower counts, bio, verification status, and metadata","exampleAgentPrompt":"Can you pull up the X profile for @coinbase — I want to see their follower count, whether they're verified, and their bio?","exampleUseCases":[{"title":"Brand social proof check","prompt":"Look up the X profile for @openai — I need their follower count, verification status, and bio to put in a competitive research doc."},{"title":"Influencer vetting before partnership","prompt":"Can you fetch the X profile for @elonmusk? I want to know their follower count, how many tweets they've posted, and when the account was created."},{"title":"Enriching a contact list with social data","prompt":"Get me the X profile info for @naval — specifically their display name, follower count, bio, and profile image URL so I can add it to our CRM enrichment."}],"resultDescription":"Returns a JSON object containing the user's numeric ID, display name, username, bio/description, location, URL, profile image URL, follower count, following count, tweet count, list count, verified flag, verification type (e.g. business), account creation timestamp, and whether the account is protected. Also includes the data source (x-api-v2) and a fetchedAt timestamp.","failureModes":["Username not found — returns an error if the handle doesn't exist or has been suspended","Invalid username format — usernames over 15 chars or with invalid characters may be rejected","Protected/private accounts — profile data may be limited or unavailable","Rate limiting — the underlying X API may throttle high-frequency requests","Payment failure — x402 payment not confirmed, call not executed"],"whenToPreferThis":"Use this endpoint when you need structured X/Twitter profile metadata (follower counts, verification status, bio, account age) without setting up your own X API credentials. Ideal for agents enriching contact records, vetting influencers, or checking brand presence on X. Pay-per-call with no signup or API key required — just supply an X username.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:54:53.436Z","isFirstParty":false}