# Agent402 X User Profile Lookup

> Agent402 X User Profile Lookup is a paid API for AI agents from agent402.tools, paid per call via x402, $0.015/call, status unknown (last checked 2026-09-13).

Fetches a public X (Twitter) user profile by username, returning follower counts, bio, verification status, and metadata

## Facts

- Endpoint: POST https://agent402.tools/api/x-user
- Price: $0.015/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent402-x-user-profile-lookup-4f30c157
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_okzBzcMfrY4iDZQesPpHL

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agent402-x-user-profile-lookup-4f30c157 -d '<json body>'
```

Example prompt: Can you pull up the X profile for @coinbase — I want to see their follower count, whether they're verified, and their bio?

## When to prefer this

Use this endpoint when you need structured X/Twitter profile metadata (follower counts, verification status, bio, account age) without setting up your own X API credentials. Ideal for agents enriching contact records, vetting influencers, or checking brand presence on X. Pay-per-call with no signup or API key required — just supply an X username.

## Known failure modes

- Username not found — returns an error if the handle doesn't exist or has been suspended
- Invalid username format — usernames over 15 chars or with invalid characters may be rejected
- Protected/private accounts — profile data may be limited or unavailable
- Rate limiting — the underlying X API may throttle high-frequency requests
- Payment failure — x402 payment not confirmed, call not executed

## How this service works

Look up one X (Twitter) account by username: id, display name, bio, account creation date, verification status and type, location, link, protected flag, and public metrics (followers, following, tweet count, listed count).

## Output

Returns a JSON object containing the user's numeric ID, display name, username, bio/description, location, URL, profile image URL, follower count, following count, tweet count, list count, verified flag, verification type (e.g. business), account creation timestamp, and whether the account is protected. Also includes the data source (x-api-v2) and a fetchedAt timestamp.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "username": {
   "type": "string",
   "description": "X username, with or without the leading @ (1-15 chars)."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "user": {
   "id": "574032254",
   "url": "https://coinbase.com",
   "name": "Coinbase",
   "metrics": {
    "listed": 9000,
    "tweets": 19000,
    "followers": 6400000,
    "following": 250
   },
   "location": "Global",
   "username": "coinbase",
   "verified": true,
   "createdAt": "2012-05-07T23:46:41.000Z",
   "protected": false,
   "profileUrl": "https://x.com/coinbase",
   "description": "The future of money is here.",
   "verifiedType": "business",
   "profileImageUrl": "https://pbs.twimg.com/profile_images/.../normal.jpg"
  },
  "source": "x-api-v2",
  "fetchedAt": "2026-08-20T14:10:00.000Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent402-x-user-profile-lookup-4f30c157/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent402.tools](https://www.zero.xyz/host/agent402.tools/llms.txt)