# ReadX Full Twitter/X Profile Lookup

> ReadX Full Twitter/X Profile Lookup is a paid API for AI agents from readx.sh, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-13, last successful call 2026-08-10).

Fetches a full X/Twitter user profile including bio, follower/following counts, banner image, pinned tweet, and photo rail for a given username.

## Facts

- Endpoint: GET https://readx.sh/api/:name/profile
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Last successful call: 2026-08-10
- Success rate: 100% of calls made through Zero
- Rating: 5.0 / 5 from 1 review
- Activations on Zero: 1
- Tags: x402
- Canonical page: https://www.zero.xyz/c/readx-full-twitter-x-profile-lookup-5df09d36
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_-PNUKxGr6Hi9TfqketGrQ

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 readx-full-twitter-x-profile-lookup-5df09d36
```

Example prompt: Can you pull up the full Twitter/X profile for the user handle 'naval' — I want their bio, follower counts, banner, pinned tweet, and photo rail.

## When to prefer this

Use this endpoint when you need a comprehensive, rich profile snapshot of an X/Twitter user in a single call — including bio, counts, banner, pinned tweet, and photo rail — rather than making multiple API calls. Prefer over basic profile endpoints when you need the full visual and social context of an account. Best for agents performing social research, influencer analysis, or building user context from a Twitter handle.

## Known failure modes

- Username not found — returns 404 or empty profile if the handle doesn't exist or the account is suspended
- Invalid handle format — returns validation error if handle contains special characters other than alphanumeric and underscore
- Private/protected account — may return limited or no profile data for locked accounts
- Rate limiting — too many requests may result in 429 errors
- Payment failure — x402 payment not processed, returns 402 Payment Required

## How this service works

Full profile: bio, counts, banner, pinned tweet and a photo rail. Example: GET /api/jack/profile

## Output

Returns a structured JSON object containing the X user's full profile: biography text, follower count, following count, tweet count, banner image URL, pinned tweet content, and a photo rail of recent media.

## 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"
    },
    "pathParams": {
     "type": "object"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "name"
     ],
     "properties": {
      "name": {
       "type": "string",
       "pattern": "^[A-Za-z0-9_]+$",
       "minLength": 1,
       "description": "X handle without the leading @ (alphanumeric and underscore)."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/readx-full-twitter-x-profile-lookup-5df09d36/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from readx.sh](https://www.zero.xyz/host/readx.sh/llms.txt)