# ReadX — Get Following List for X/Twitter User

> ReadX — Get Following List for X/Twitter User 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).

Returns a paginated list of accounts that a given X/Twitter username is following, with full profile details for each account

## Facts

- Endpoint: GET https://readx.sh/api/%7Bname%7D/following_web
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/readx-get-following-list-for-x-twitter-user-d05666c2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_SZzSfZ3aqeiWcxuXENgMK

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-get-following-list-for-x-twitter-user-d05666c2
```

Example prompt: Can you pull up the list of accounts that @jack follows on X, and paginate through all of them for me?

## When to prefer this

Choose this endpoint when you need programmatic access to an X/Twitter user's following list without Twitter API credentials or OAuth setup. It is ideal for social graph analysis, influencer research, competitor monitoring, or any agent workflow needing structured JSON following data at low cost ($0.01/call) with micropayment via USDC on Base or Solana. Prefer this over the official Twitter API when you want no API key management overhead and pay-per-call pricing.

## Known failure modes

- Unknown or misspelled username returns empty result or error code
- Private/protected account following list may be inaccessible
- Pagination cursor expiration causing loss of position in large lists
- Rate limiting or temporary service unavailability returning non-zero error code
- Username with no following returns empty users array with total_count of 0
- Network timeout on very large following lists

## 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 an array of user profile objects (each with id, username, fullname, bio, location, website, profile picture, banner, follower count, following count, tweet count, join date, verification type, protected/suspended status, and pinned tweet ID), a total_count of accounts followed, and pagination metadata (has_more boolean and next_cursor string for fetching subsequent pages).

## 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": {
   "users": [
    {
     "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"
    }
   ],
   "total_count": 70
  },
  "pagination": {
   "has_more": true,
   "next_cursor": "DAABCgABG...cursor"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/readx-get-following-list-for-x-twitter-user-d05666c2/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)