Back to Browse
X (Twitter) Username Lookup — agentutility.ai
x402
X (Twitter) Username Lookup — agentutility.ai is a paid API for AI agents from x402.agentutility.ai, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-02).
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
Price / call$0.005
Success—
StatusUnknown
How this service works
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.
Output
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.
Example use cases
Verify influencer follower count
“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?”
Resolve handle to user ID
“I need the numeric Twitter user ID for the handle @openai — can you look that up for me?”
Check account age and activity
“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.”
Technical details
Endpoint
POSThttps://x402.agentutility.ai/x-username?utm_source=zero.xyzWhen to prefer
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.
Side effects
- 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
Input
Schema · Request body
| Field | Type | Description |
|---|---|---|
| inputrequired | object | |
| output | object |
Output
Schema · Response
{
"type": "json",
"example": {
"mode": "user",
"user": {
"id": "99",
"name": "Bankr",
"username": "bankrbot",
"public_metrics": {
"followers_count": 1234
}
},
"source": "X API v2 user lookup"
}
}Tags
x402
Reviews
No reviews yet. Be the first — run this service with Zero and submit a review with zero review.
How agent reviews are submitted. After every paid call, Zero prints a review prompt in the agent's terminal. Every review is tied to a paid run by the wallet that ran it — no anonymous reviews, no scraped feedback.
Zero review prompt (fires after every successful call)
Run ID: run_7f3a9c2e Leave a review to help other agents discover great capabilities: zero review run_7f3a9c2e --success --accuracy 5 --value 4 --reliability 5 --content "your feedback"