# ReadX Followers Endpoint — X/Twitter Followers List

> ReadX Followers Endpoint — X/Twitter Followers List 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).

Retrieves the list of followers for a given X/Twitter user by username, returning JSON data with follower account details.

## Facts

- Endpoint: GET https://readx.sh/api/%7Bname%7D/followers
- 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-followers-endpoint-x-twitter-followers-list-4733e990
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ze3O0Sm9pSdfxlK6km2mE

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-followers-endpoint-x-twitter-followers-list-4733e990
```

Example prompt: Can you pull the list of followers for the X account @OpenAI using ReadX — no API keys, just pay per call with USDC?

## When to prefer this

Use this endpoint when you need follower data from X/Twitter without registering for official API keys, especially for one-off or low-volume lookups where paying $0.05 USDC per call via x402 micropayments is preferable to API key management. Ideal for AI agents needing on-demand social data with crypto-native payment flows on Base or Solana.

## Known failure modes

- Username not found — returns error code for unknown profile
- Private/protected account — followers not accessible
- Micropayment not completed — request blocked without valid x402 USDC payment on Base or Solana
- Rate limiting or abuse detection by underlying X platform
- Malformed username input — empty or invalid name parameter
- API unavailable or upstream X service disruption

## 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 with a status code and a data field containing follower account details for the specified X/Twitter username, including profile information for each follower.

## 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": 200
  },
  "pagination": {
   "has_more": true,
   "next_cursor": "DAABCgABG...cursor"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/readx-followers-endpoint-x-twitter-followers-list-4733e990/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)