# X User Profile Lookup

> X User Profile Lookup is a paid API for AI agents from x402.botsmith.dev, paid per call via x402, $0.015/call, status unknown (last checked 2026-10-23).

Fetch public profile data for an X (Twitter) account by handle, including bio, follower counts, verification status, and account age.

## Facts

- Endpoint: GET https://x402.botsmith.dev/x/user?utm_source=zero.xyz
- Price: $0.015/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-23
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x-user-profile-lookup-3e69e733
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_46Q_k4Lwn1bMeXKVIpJX1

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 x-user-profile-lookup-3e69e733
```

Example prompt: Can you pull up the X profile for @elonmusk — I want to see their bio, follower count, verification status, and how old the account is?

## When to prefer this

Use this endpoint when you need to look up an X/Twitter user's public profile data by handle without needing your own X developer account or API key. It is ideal for enriching contact records, vetting influencers, checking account age and authenticity, or gathering social proof signals. Prefer it over direct X API calls when you lack API credentials or want a simple pay-per-call model at $0.005/call.

## Known failure modes

- Handle not found or account suspended — returns null fields or error
- Invalid handle format (over 15 chars or bad characters) — rejected by schema validation
- Account is private — some fields may be null
- Rate limiting or upstream X API unavailability — service error response
- Passing a numeric tweet ID instead of a handle — wrong parameter

## How this service works

X User Profile ($0.015/call): Fetch an X (Twitter) account by handle: display name, bio, follower/following/tweet counts, account creation date and age in days, verification status, location and profile image. No X account or API key needed.

## Output

Returns a JSON object with the account's handle, numeric ID, display name, bio, profile URL, location, profile image URL, verified status (blue check and type), follower count, following count, tweet count, account creation date (ISO 8601), and account age in days.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "handle"
     ],
     "properties": {
      "handle": {
       "type": "string",
       "pattern": "^@?[A-Za-z0-9_]{1,15}$",
       "description": "X handle, with or without the leading @"
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "handle",
      "id",
      "name",
      "bio",
      "url",
      "location",
      "profileImage",
      "verified",
      "followers",
      "following",
      "tweetCount",
      "createdAt",
      "accountAgeDays"
     ],
     "properties": {
      "id": {
       "anyOf": [
        {
         "type": "string"
        },
        {
         "type": "null"
        }
       ]
      },
      "bio": {
       "anyOf": [
        {
         "type": "string"
        },
        {
         "type": "null"
        }
       ]
      },
      "url": {
       "anyOf": [
        {
         "type": "string"
        },
        {
         "type": "null"
        }
       ]
      },
      "name": {
       "anyOf": [
        {
         "type": "string"
        },
        {
         "type": "null"
        }
       ]
      },
      "handle": {
       "type": "string"
      },
      "location": {
       "anyOf": [
        {
         "type": "string"
        },
        {
         "type": "null"
        }
       ]
      },
      "verified": {
       "type": "object",
       "required": [
        "blue",
        "type"
       ],
       "properties": {
        "blue": {
         "type": "boolean"
        },
        "type": {
         "anyOf": [
          {
           "type": "string"
          },
          {
           "type": "null"
          }
         ]
        }
       },
       "additionalProperties": false
      },
      "createdAt": {
       "anyOf": [
        {
         "type": "string"
        },
        {
         "type": "null"
        }
       ],
       "descr
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x-user-profile-lookup-3e69e733/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.botsmith.dev](https://www.zero.xyz/host/x402.botsmith.dev/llms.txt)