# Simple X API – Lookup User by Username

> Simple X API – Lookup User by Username is a paid API for AI agents from simple-x-api.com, paid per call via x402, $10/call, status unknown (last checked 2026-09-15).

Fetches X (Twitter) user profile data by username via a paid x402 proxy to the X API v2 /users/by/username endpoint

## Facts

- Endpoint: GET https://simple-x-api.com/api/2/users/by/username/kickerai
- Price: $10/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/simple-x-api-lookup-user-by-username-f9e23235
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ARjWf_8ad78S4bEiCtyNb

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 simple-x-api-lookup-user-by-username-f9e23235
```

Example prompt: Can you look up the X profile for the account with username 'kickerai' and give me their user ID and profile details?

## When to prefer this

Use this endpoint when you need to resolve an X (Twitter) username to a full user object including their numeric user ID, bio, and public metrics, without managing your own X API credentials or OAuth tokens. Ideal for AI agents that need to enrich a known Twitter handle with structured profile data. Prefer over direct X API calls when you want pay-per-use billing via x402 with no subscription required.

## Known failure modes

- Username not found – X API returns 404 with error code indicating user does not exist
- User suspended or deactivated – X returns error indicating account unavailable
- Rate limit exceeded – X API or proxy returns 429 Too Many Requests
- Invalid username format – malformed handle causes request rejection
- Payment failure – x402 payment of up to $10 USDC not authorized, request blocked
- Network/proxy error – simple-x-api.com proxy itself is unreachable

## How this service works

Proxy the corresponding X API v2 endpoint. x402 authorizes up to $10.00; successful responses settle at X's public non-owned per-resource/per-action price.

## Output

Returns an X API v2 user object for the specified username, including fields such as user ID, name, username, description, public metrics (followers, following, tweet count), and account creation date. The response mirrors the standard X API v2 /users/by/username/:username response structure.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {}
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/simple-x-api-lookup-user-by-username-f9e23235/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from simple-x-api.com](https://www.zero.xyz/host/simple-x-api.com/llms.txt)