# ReadX — X/Twitter JSON API (Paid Per Call)

> ReadX — X/Twitter JSON API (Paid Per Call) 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 read-only X/Twitter data (profiles, timelines, tweets, search, lists, followers, following) via JSON API with per-call USDC micropayments using x402, no API keys required.

## Facts

- Endpoint: GET https://readx.sh/api/%7Bname%7D
- 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-json-api-paid-per-call-a665e225
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_cdr6qmvJROtbVJXZCypgL

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-json-api-paid-per-call-a665e225
```

Example prompt: Pull the latest 20 tweets from @elonmusk's timeline on X — I want the tweet text, timestamps, and like counts in JSON.

## When to prefer this

Choose ReadX when you need programmatic read access to X/Twitter data without going through the official Twitter developer API key process, especially when operating in a crypto-native or x402-payment context where per-call USDC micropayments are acceptable and no long-term API credentials are desired.

## Known failure modes

- Payment not sent or insufficient USDC — 402 Payment Required response
- Invalid or non-existent username/tweet ID — returns error code in JSON body
- Rate limits on the underlying X/Twitter API — upstream errors propagated
- Malformed endpoint path — no matching route returns error
- Requested account is private or suspended — data unavailable

## 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

Returns a JSON object with a status code and a data payload containing the requested X/Twitter resource (profile fields, tweet objects, timeline arrays, follower/following lists, or search result sets) depending on the endpoint called.

## 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": {
   "timeline": [
    {
     "id": "20",
     "card": null,
     "isAI": false,
     "isAd": false,
     "note": null,
     "poll": null,
     "text": "just setting up my twttr",
     "time": 1142974214,
     "user": {
      "id": "12",
      "bio": "",
      "likes": 0,
      "media": 0,
      "banner": "",
      "tweets": 30000,
      "userPic": "",
      "website": "",
      "fullname": "jack",
      "joinDate": 1142974214,
      "location": "",
      "username": "jack",
      "followers": 6500000,
      "following": 4000,
      "protected": false,
      "suspended": false,
      "pinnedTweet": "0",
      "verifiedType": "Blue"
     },
     "media": null,
     "quote": null,
     "reply": [],
     "stats": {
      "likes": 200000,
      "views": 0,
      "quotes": 9000,
      "replies": 200000,
      "retweets": 130000
     },
     "pinned": false,
     "source": "",
     "history": null,
     "replyId": "0",
     "retweet": null,
     "location": "",
     "threadId": "20",
     "available": true,
     "hasThread": false,
     "mediaTags": null,
     "tombstone": "",
     "attribution": null
    }
   ]
  },
  "pagination": {
   "has_more": true,
   "next_cursor": "DAABCgAB...cursor",
   "is_first_page": true
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/readx-x-twitter-json-api-paid-per-call-a665e225/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)