# Twitter List Members

> Twitter 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-10-18, last successful call 2026-05-27).

Returns paginated member profiles for a specific Twitter/X list, including user details and public metrics

## Facts

- Endpoint: POST https://twitter.surf.cascade.fyi/lists/2045135579608699278/members?utm_source=zero.xyz
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-18
- Last successful call: 2026-05-27
- Success rate: 50% of calls made through Zero
- Activations on Zero: 2
- Tags: x402
- Canonical page: https://www.zero.xyz/c/twitter-surf-cascade-fyi-9dbae659
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__3rAd5N5eseM471BQjGqx

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 twitter-surf-cascade-fyi-9dbae659 -d '<json body>'
```

Example prompt: Show me all the member profiles — including bios, follower counts, and verification status — for the Twitter list with ID 2045135579608699278.

## When to prefer this

Use this endpoint when you need to enumerate and inspect the Twitter/X user profiles that belong to a specific curated list, especially when you want structured profile metadata (bios, follower counts, verification) for each member. Prefer this over user-search endpoints when you already have a list ID and want a pre-curated set of accounts. Useful for building audience analysis, monitoring who is in a thought-leader list, or seeding enrichment pipelines.

## Known failure modes

- List ID not found or deleted — empty data array returned
- Invalid or expired pagination cursor — pagination error or unexpected results
- Rate limit exceeded — HTTP 429 response
- Payment not processed — HTTP 402 requiring x402 payment of 0.004 USDC
- List is private and not accessible — authorization error

## How this service works

Returns the members of a specified X/Twitter list.

## Output

Returns an array of user profile objects, each containing id, name, username, location, description, verified flag, verified_type, created_at, profile_image_url, cover_image_url, and public_metrics (followers_count, following_count, tweet_count, like_count, media_count). Also includes pagination metadata: next_cursor, result_count, and has_next_page.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {}
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/twitter-surf-cascade-fyi-9dbae659/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)