# Agent402 X (Twitter) Users Lookup

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

Looks up public profile metadata for 1-10 X (Twitter) usernames in a single call, returning follower counts, verification status, bio, and more.

## Facts

- Endpoint: POST https://agent402.tools/api/x-users-lookup
- Price: $0.15/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-twitter-users-lookup-e0042a23
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_O_uaJ0O3JHTVv4taus-SO

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-twitter-users-lookup-e0042a23 -d '<json body>'
```

Example prompt: Look up the X profiles for the usernames 'coinbase', 'vitalikbuterin', and 'elonmusk' and tell me their follower counts, verification status, and bios.

## When to prefer this

Choose this endpoint when you need structured public profile metadata — follower counts, verification type, user IDs, bios — for up to 10 X usernames in a single no-signup, no-API-key call paid per-use in USDC. Prefer it over maintaining your own X API credentials when you need lightweight, ad-hoc social profile lookups without a long-term subscription, or when building an agent that must resolve X handles to numeric IDs or validate account existence on demand.

## Known failure modes

- Username not found: listed in 'notFound' array rather than throwing an error
- More than 10 usernames submitted: may return an error or truncate results
- Invalid input format (non-string items): request validation error
- X API rate limiting or downtime: upstream error propagated
- Payment failure (insufficient USDC balance): 402 Payment Required before query executes

## How this service works

Look up up to 10 X (Twitter) accounts by username in one call. Returns each found profile with public metrics (followers, following, tweets, listed), verification status and bio, plus the list of usernames X did not resolve.

## Output

Returns a JSON object with a count of found users, an array of user objects each containing numeric ID, display name, username, bio/description, location, profile URL, profile image URL, follower/following/tweet/listed counts, verified flag, verification type (e.g. 'business'), account creation timestamp, and protected status. Also includes a 'notFound' array of usernames that could not be resolved, plus a 'fetchedAt' timestamp and source label ('x-api-v2').

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "usernames": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "description": "1-10 usernames (array, or a comma-separated string)."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "users": [
   {
    "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",
  "notFound": [
   "nosuchuser_xyz"
  ],
  "fetchedAt": "2026-08-20T14:10:00.000Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent402-x-twitter-users-lookup-e0042a23/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)