{"uid":"cap_HwxkgHF93oeoPwGnujTEq","slug":"payweave-twitter-lookup-user-profile-by-username-c4c1968b","name":"PayWeave Twitter – Lookup User Profile by Username","description":"X/Twitter data — tweets, users, communities, lists, articles, and trends.","url":"https://twitter.payweave.services/users/by/username","method":"GET","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":{"anyOf":[{"not":{}},{"type":"object","required":["username"],"properties":{"username":{"type":"string","minLength":1,"description":"X handle / screen name (without @), e.g. elonmusk."}},"additionalProperties":false}]},"type":{"type":"string","const":"http"},"method":{"type":"string","const":"GET"},"bodyType":{"type":"string","const":"json"}},"additionalProperties":false},"output":{"type":"object","required":["example"],"properties":{"example":{"type":"object","properties":{},"description":"User-profile JSON forwarded verbatim from twitterapi.io.","additionalProperties":true}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.0006","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.0006/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0006","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0006","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_SjOz_b7tiUAAB5ouN9id-","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0006","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 public profile JSON by their screen name (handle), proxied via twitterapi.io, billed per call over x402.","exampleAgentPrompt":"Can you look up the Twitter profile for the username 'paulg' and tell me their bio, follower count, and whether they're verified?","exampleUseCases":[{"title":"Journalist researching public figures","prompt":"Pull the public Twitter profile for the account 'naval' — I want their display name, bio, follower count, and when the account was created."},{"title":"Brand monitoring account lookup","prompt":"Can you grab the Twitter profile info for the handle 'OpenAI' so I can see their current bio, follower count, and verification status?"},{"title":"Lead enrichment from social handle","prompt":"I have the Twitter username 'sama' — can you fetch their full public profile so I can add their bio and follower count to my CRM record?"}],"resultDescription":"A user-profile JSON object forwarded verbatim from twitterapi.io, typically containing fields such as display name, screen name, bio/description, follower count, following count, tweet count, account creation date, profile image URL, and verification status.","failureModes":["Username not found: returns an error or empty result if the handle does not exist or the account is suspended","Rate or quota limits from the underlying twitterapi.io provider causing transient failures","Malformed or missing username input (minLength:1 not met) causes schema validation rejection","Network or payment settlement failure under x402 protocol resulting in no response","Private or deactivated accounts may return limited or no data"],"whenToPreferThis":"Choose this endpoint when you need to resolve a single Twitter/X screen name to a full public profile object in real time, especially when you want pay-per-call billing with no subscription commitment. Prefer it over scraping or official Twitter API v2 when you need instant per-query micropayment pricing via x402/USDC and don't want to manage API keys or rate-limit tiers.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:45:49.252Z","isFirstParty":false}