{"uid":"cap_BT5nF8-ts0wKYGi4XWE08","slug":"x-twitter-username-lookup-agentutility-ai-2db82e67","name":"X (Twitter) Username Lookup — agentutility.ai","description":"X username lookup / Twitter username lookup / handle resolver / public profile lookup / follower count API. Read-only X API v2 user-by-username wrapper. Accepts a handle with or without @ and returns id, username, display name, bio, verification fields, created_at, followers, following, tweet count, and listed count. Requires X_BEARER_TOKEN; no posting, replying, liking, following, or account mutation.","url":"https://x402.agentutility.ai/x-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_EwelsConun8xwDmLDna3U","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 profile including user ID, display name, bio, verification status, follower/following counts, tweet count, and creation date","exampleAgentPrompt":"Look up the X profile for @elonmusk and tell me their follower count, bio, and whether they're verified.","exampleUseCases":[{"title":"Verify influencer follower count","prompt":"Can you pull the current follower count and bio for the X account @MrBeast so I can decide whether to move forward with this sponsorship?"},{"title":"Resolve handle to user ID","prompt":"I need the numeric Twitter user ID for the handle @openai — can you look that up for me?"},{"title":"Check account age and activity","prompt":"Look up the X profile for @sama and tell me when the account was created, how many tweets they've posted, and how many people they follow."}],"resultDescription":"A JSON object containing the user's numeric X ID, username, display name, bio/description, verification fields (verified, verified_type), account creation timestamp, follower count, following count, total tweet count, and listed count — all sourced from the X API v2 user-by-username endpoint.","failureModes":["Handle not found (user does not exist or has been suspended) — returns error or empty result","Invalid or expired X_BEARER_TOKEN — authentication failure","Rate limit exceeded on the underlying X API v2 — temporary unavailability","Handle passed with special characters or spaces — malformed request","Account is private or deactivated — limited or no profile data returned"],"whenToPreferThis":"Choose this endpoint when you need read-only public profile data for an X/Twitter user and want a simple, pay-per-call interface without managing X API credentials or rate limits yourself. It is ideal for agents that need to enrich data pipelines with Twitter profile metadata, verify influencer stats, or resolve handles to canonical user IDs. Prefer it over direct X API calls when you want USDC-settled micropayment access (x402 protocol) with no OAuth setup.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T18:49:00.826Z","isFirstParty":false,"canonicalSlug":"x-twitter-username-lookup-agentutility-ai-2db82e67"}