# AgentUtility X Users Lookup

> AgentUtility X Users Lookup is a paid API for AI agents from x402.agentutility.ai, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Bulk lookup of public Twitter/X user profiles and metrics by username or numeric user ID via X API v2

## Facts

- Endpoint: POST https://x402.agentutility.ai/x-users
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentutility-x-users-lookup-66fda193
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_bKJyZulmQ7GOrc_d5OiMX

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 agentutility-x-users-lookup-66fda193 -d '<json body>'
```

Example prompt: Look up the public X profiles for the accounts @elonmusk, @sama, and @karpathy — I need their follower counts, bios, verified status, and tweet counts.

## When to prefer this

Choose this endpoint when you need public X/Twitter profile data — follower counts, bios, verification status, or account metrics — for one or more accounts in a single call. It is the right choice for bulk resolution of usernames to profile metadata, influencer vetting, social graph enrichment, or any workflow where you need read-only X profile fields without building your own X API integration. It accepts both @usernames and numeric user IDs, making it useful for ID-to-profile resolution as well.

## Known failure modes

- Username or user ID not found — returns 404 or empty result for that entry
- Rate limit or quota exceeded on the underlying X API v2
- Invalid username format or malformed user ID — validation error
- Account suspended or deactivated — no profile data returned
- Payment failure via x402 protocol — request rejected before reaching X API
- Partial results if some usernames in a bulk request are invalid while others succeed

## How this service works

X users API / bulk Twitter profile lookup / public social profile lookup. Same read-only X API v2 backend as users. Accepts usernames or numeric user IDs and returns public profile and metric fields.

## Output

Returns a structured array of public X/Twitter profile records for each requested username or user ID, including display name, bio, follower count, following count, tweet count, verified status, profile image URL, and account creation date as available from the X API v2 public fields.

## Request schema (JSON Schema)

```json
{
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "type": "object",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "type": "string",
     "enum": [
      "POST"
     ]
    },
    "bodyType": {
     "type": "string",
     "enum": [
      "json",
      "form-data",
      "text"
     ]
    },
    "body": {
     "properties": {
      "mode": {
       "type": "string",
       "enum": [
        "users"
       ],
       "description": "Optional. Operation mode; set to 'users' for bulk lookup. Accepts search, user, tweets, users, or user_tweets."
      },
      "usernames": {
       "type": "array",
       "items": {
        "type": "string"
       },
       "description": "X handles to look up, with or without @. Up to 100, deduplicated. Provide this or user_ids/ids."
      },
      "user_ids": {
       "type": "array",
       "items": {
        "type": "string"
       },
       "description": "Numeric X user IDs to look up. Up to 100. Used only when usernames is omitted."
      },
      "ids": {
       "type": "array",
       "items": {
        "type": "string"
       },
       "description": "Alias for user_ids: numeric X user IDs, used when usernames is omitted."
      }
     }
    }
   },
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "mode": {
       "type": "string"
      },
      "requested": {
       "type": "integer"
      },
      "result_count": {
       "type": "integer"
      },
      "source": {
       "type": "string"
      }
     }
    }
   },
   "required": [
    "type"
   ]
  }
 },
 "required": [
  "input"
 ]
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "mode": "users",
  "source": "X API v2 users lookup",
  "requested": 1,
  "result_count": 1
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentutility-x-users-lookup-66fda193/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.agentutility.ai](https://www.zero.xyz/host/x402.agentutility.ai/llms.txt)