# Surf Twitter - Twitter/X List Members

> Surf Twitter - Twitter/X List Members is a paid API for AI agents from twitter.surf.cascade.fyi, paid per call via x402, $0.004/call, status unknown (last checked 2026-09-08).

Retrieves the member list of a Twitter/X list by list ID, returning member names, usernames, and follower counts with pagination support.

## Facts

- Endpoint: GET https://twitter.surf.cascade.fyi/lists/%7Bid%7D/members
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-08
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/surf-twitter-twitter-x-list-members-1ed5ab01
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_D7IZQT2voOCqXoOuNlo8p

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 surf-twitter-twitter-x-list-members-1ed5ab01
```

Example prompt: Can you pull all the members of Twitter list 1234567890 and tell me their usernames and how many followers each one has?

## When to prefer this

Use this endpoint when you need to enumerate the members of a specific Twitter/X list and have the list ID. Prefer this over scraping or OAuth-based Twitter API access when you want a pay-per-use model with no subscription, and when you need structured follower counts alongside member handles. Ideal for agents that need to build audience lists, audit list composition, or enrich data about Twitter communities.

## Known failure modes

- Invalid or non-existent list ID returns a 404 or empty data array
- Insufficient USDC balance for x402 micropayment returns a 402 Payment Required error
- Private or restricted list returns an authorization error
- Rate limiting or upstream Twitter API errors may return 5xx responses
- Malformed list ID (non-numeric or wrong format) returns a 400 error

## How this service works

Pay-per-use Twitter/X data API with x402 micropayments.

## Output

A JSON object containing an array of member objects (each with name, username, and followers_count) plus pagination metadata including result_count and has_next_page, allowing the agent to iterate through all list members.

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": [
   {
    "name": "Member",
    "username": "member1",
    "followers_count": 1000
   }
  ],
  "meta": {
   "result_count": 20,
   "has_next_page": true
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/surf-twitter-twitter-x-list-members-1ed5ab01/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from twitter.surf.cascade.fyi](https://www.zero.xyz/host/twitter.surf.cascade.fyi/llms.txt)