# ReadX List Members API

> ReadX List Members 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-16).

Retrieves the members of a specific X/Twitter list by list ID, returning user profile data as JSON, paid per call via USDC micropayments.

## Facts

- Endpoint: GET https://readx.sh/api/lists/%7Bid%7D/members
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/readx-list-members-api-085029ec
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_lLVNEYH0TgaD9qJQDeEbW

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-list-members-api-085029ec
```

Example prompt: Can you fetch all the members of the Twitter list with ID 1234567890? I want to see who's in that list.

## When to prefer this

Use this endpoint when you need to programmatically retrieve the members of a specific X/Twitter list without an official Twitter API key, paying only per call via USDC micropayments on Base or Solana. Prefer this over the official Twitter API when you want to avoid API key setup, rate limit tiers, or subscription plans — ideal for agents making occasional or ad-hoc list membership lookups.

## Known failure modes

- Invalid or non-existent list ID returns an error code in the JSON response
- Private or restricted list that is not accessible returns an authorization error
- Insufficient USDC balance or failed x402 micropayment results in 402 Payment Required response
- Malformed list ID format causes a bad request error
- Rate limiting or upstream X/Twitter API outage may return a service unavailable error

## 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 a list of user profiles who are members of the specified X/Twitter list, including account details such as usernames, display names, follower counts, and other profile metadata, returned with a status code of 0 on success.

## 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": 0,
     "userPic": "",
     "website": "",
     "fullname": "Someone",
     "joinDate": 0,
     "location": "",
     "username": "someone",
     "followers": 0,
     "following": 0,
     "protected": false,
     "suspended": false,
     "pinnedTweet": "0",
     "verifiedType": "None"
    }
   ],
   "total_count": 20
  },
  "pagination": {
   "has_more": true,
   "next_cursor": "DAABCgABG...cursor"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/readx-list-members-api-085029ec/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)