# ReadX X/Twitter Profile Lookup API

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

Fetches a public X/Twitter user profile in JSON format by username, paid per call via USDC micropayments with no API keys required.

## Facts

- Endpoint: GET https://readx.sh/api/%7Bname%7D/profile
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-08
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/readx-x-twitter-profile-lookup-api-ee2fb085
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_tWMo4iM1HTYkGGpkRAClm

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-x-twitter-profile-lookup-api-ee2fb085
```

Example prompt: Pull up the X profile for @elonmusk — I want to see their bio, follower count, and account details.

## When to prefer this

Use this endpoint when you need to fetch a single X/Twitter user's public profile data without managing Twitter API keys or OAuth credentials. Ideal for agents that need social profile enrichment on a pay-per-use basis with USDC micropayments via x402. Best for low-to-moderate volume lookups where per-call pricing is more economical than a monthly API subscription.

## Known failure modes

- Username not found — returns error code with empty data object
- Invalid or suspended account — API may return error or empty data
- Payment failure via x402 — call not processed if USDC payment rejected
- Rate limiting or upstream X API outage — intermittent errors
- Malformed username in path — bad request response

## How this service works

ReadX is a read-only X/Twitter JSON API. Profiles, timelines, tweets, search, lists, followers & following — pay per call with x402 micropayments in USDC on Base or Solana. No API keys.

## Output

A JSON object containing the public X/Twitter profile data for the requested username, including display name, bio, follower count, following count, tweet count, profile image, and other account metadata.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "required": {
   "type": "string"
  },
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "code": 0,
  "data": {
   "user": {
    "id": "12",
    "bio": "",
    "tweets": 30000,
    "fullname": "jack",
    "joinDate": 1142974214,
    "username": "jack",
    "followers": 6500000,
    "following": 4000,
    "verifiedType": "Blue"
   },
   "pinned": null,
   "photoRail": []
  }
 }
}
```

## More

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