Name: x-username
Price: 0.005 USDC
Availability: InStock

$ man x-username

agentutility / web-probe / x-username

PRICE / CALL

$0.005

USDC · base mainnet · scheme: exact

METHOD

POST

CLUSTER

webprobe

CATEGORY

uncategorized

STATUS

● live

NAME

x-username — looks up a public x profile by username, wrapping the read-only x api v2 user-by-username route

SYNOPSIS

POST https://x402.agentutility.ai/x-username
     Content-Type: application/json
     X-PAYMENT:    <signed-transferWithAuthorization>

     { ... }

↳ first call → 402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.

DESCRIPTION

Looks up a public X profile by username, wrapping the read-only X API v2 user-by-username route. 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. Use it as a Twitter username lookup, handle resolver, public profile lookup, or follower count API.

INPUT — request schema

property	type	description	req?
username	string	X/Twitter handle, with or without @, e.g. 'bankrbot'.	required

OUTPUT — response shape

field	type	description
mode	string	—
user	string	—
source	string	—

EXAMPLES — two ways to call

EXAMPLE 1 · curl

curl -X POST https://x402.agentutility.ai/x-username \
  -H 'Content-Type: application/json' \
  -d '{ }'

first response = 402 Payment Required with payment requirements; sign + retry with X-PAYMENT.

EXAMPLE 2 · mcp

# Install the MCP package for this endpoint's cluster
npx -y @agentutility/mcp-<cluster>

# Required: EVM private key with USDC on Base
export X402_PRIVATE_KEY=0x...

# Then call the x-username tool from your MCP-aware agent.

MCP server handles payment automatically — your coding agent just calls the tool by name.

METADATA

tags: web-probexusernamex-username
methods: POST
cluster: webprobe
price: $0.005 USDC per call

ADJACENT — other endpoints in webprobe

endpoint	description	price
arxiv-bibtex	Turns an arXiv paper into a BibTeX entry: pulls title, authors, year, abstract, and DOI from the arXiv API and generates a properly-forma…	$0.005
brand-domain-check	Checks whether a brand or company domain is established, expiring, registrar-locked, or newly registered, on the same RDAP backend as who…	$0.005
brand-name-score	Scores a candidate brand or startup name on quality and risk.	$0.005
brand-watch-domain-risk	Checks new or suspicious brand-adjacent domains for age, registrar, expiry, DNSSEC, and transfer/lock statuses.	$0.005
company-name-score	Scores the quality of a company name before you commit to domain, handle, trademark, and launch work.	$0.005
creator-domain-check	Checks creator, newsletter, podcast, and community domains for age, expiry, registrar, DNSSEC, and suspicious new-registration flags.	$0.005
crypto-headlines	Crypto headlines API for agents that need breaking cryptocurrency news by topic or query.	$0.005
crypto-news	Crypto news API that searches recent cryptocurrency headlines for a topic, token, protocol, or market event.	$0.005