{"uid":"cap_8COmX2UMYgcTX6Oky3Eca","slug":"x-twitter-user-profile-lookup-260a5fd4","name":"X (Twitter) User Profile Lookup","description":"X User Profile Lookup: one public X (Twitter) account by handle or x.com URL: display name, bio, followers, following, post count, verification, avatar link and creation time, in the shared social schema. Bad input is free; not found or no match is not charged.","url":"https://social.duoleads.com/v1/x/profile?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":["handle"],"properties":{"handle":{"type":"string","maxLength":200,"description":"An X handle (with or without @) or an x.com profile URL."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"as_of":"2026-10-15T12:00:00.000Z","items":[{"id":"20000001","url":"https://x.com/synthbrand","lang":null,"text":"Synthetic account for tests.","type":"profile","author":{"handle":"synthbrand","verified":true,"followers":44240,"display_name":"Synthetic Brand"},"metrics":{"likes":null,"views":null,"replies":null,"reposts":null},"profile":{"posts":213,"following":81,"likes_total":99},"platform":"x","parent_id":null,"created_at":"2014-03-12T09:30:00.000Z","media_urls":["https://pbs.twimg.invalid/profile/synthbrand.jpg"]}],"query":{"handle":"synthbrand"},"source":"public data via third-party provider; not affiliated with the platform","complete":true,"platform":"x","disclaimer":"Public data via third-party providers; not affiliated with or endorsed by any platform. Do not use to profile, target or train AI on individuals.","request_id":"01KEXAMPLE0000000000000000","next_cursor":null}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_P3IViA4bEHlL1inF8mbXq","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches a single public X (Twitter) account's profile data—display name, bio, follower/following counts, post count, verification status, avatar URL, and account creation date—by handle or x.com URL.","exampleAgentPrompt":"Can you look up the public X profile for @elonmusk — I want their follower count, bio, verification status, and when the account was created?","exampleUseCases":[{"title":"Influencer vetting before campaign","prompt":"Pull up the X profile for @MorningBrewDaily — I need to see their follower count, following count, number of posts, and whether they're verified before we decide on a sponsorship deal."},{"title":"Detecting fake or new accounts","prompt":"Check when the X account @cryptoalpha99 was created and how many followers they have — I want to know if this account is brand new or potentially suspicious before I engage with them."},{"title":"Enriching a CRM with social data","prompt":"I have a lead whose Twitter handle is @janedoe_design — can you grab her public X profile so I can add her follower count, bio, and avatar to her contact record?"}],"resultDescription":"Returns a JSON object containing the matched X account's user ID, handle, display name, bio text, follower count, following count, total post count, total likes, verification flag, avatar image URL, account creation timestamp, and platform identifier. Also includes query echo, a request ID, data source disclaimer, and a completeness flag.","failureModes":["Handle not found or account does not exist — returns empty items array, not charged","Malformed or invalid handle input — treated as bad input, not charged","Private or suspended account — no data returned","Rate limiting or upstream provider unavailability — may return error","Handle with special characters or typos causing no match"],"whenToPreferThis":"Choose this endpoint when you need a structured snapshot of a single public X/Twitter account's profile metrics and metadata by handle or URL. It is ideal for CRM enrichment, influencer vetting, account age/verification checks, and social research pipelines. It returns a normalized social schema consistent with sibling endpoints (Instagram, LinkedIn, etc.), making it easy to compare profiles across platforms. Bad input is free, so it is safe to call speculatively.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T12:34:36.866Z","isFirstParty":false,"canonicalSlug":"x-twitter-user-profile-lookup-260a5fd4"}