# twit.sh List Members

> twit.sh List Members is a paid API for AI agents from twit.sh, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Returns the members of a Twitter/X list by list ID, with user profiles and public metrics, paginated

## Facts

- Endpoint: GET https://twit.sh/lists/members
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/twit-sh-list-members-6fd6c58b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_DNb8CbTFc4jN8EyNNA7BV

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 twit-sh-list-members-6fd6c58b
```

Example prompt: Pull the members of Twitter list 123456789 and show me their usernames, follower counts, and bios — get the first page of results.

## When to prefer this

Use this endpoint when you need to enumerate the members of a specific Twitter/X list by its numeric ID, especially in autonomous agent workflows where no manual API key setup is feasible. Prefer this over scraping or the official Twitter API when you need pay-per-use access without OAuth setup and want real-time data billed in USDC on Base via x402.

## Known failure modes

- Invalid or non-existent list ID returns an empty data array or error
- Private or deleted lists may return no members or an access error
- Expired or invalid next_token returns a pagination error
- Rate limits or payment failures return a 402 or 429 response
- List with zero members returns an empty data array

## How this service works

Real-time Twitter/X data for AI agents. No sign-up, no API keys. Pay per request in USDC on Base via x402. Fully autonomous.

## Output

Returns a paginated array of user objects, each containing numeric user ID, display name, username, verified status, bio/description, and public metrics (follower count, following count, tweet count, like count). Also returns a next_token for fetching additional pages.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "id"
     ],
     "properties": {
      "id": {
       "type": "string",
       "description": "Numeric Twitter/X List ID"
      },
      "next_token": {
       "type": "string",
       "description": "Pagination cursor from previous response"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": [
   {
    "id": "9253672",
    "name": "Hal Finney",
    "username": "halfin",
    "verified": false,
    "description": "Running bitcoin.",
    "public_metrics": {
     "like_count": 300,
     "tweet_count": 600,
     "followers_count": 134000,
     "following_count": 200
    }
   }
  ],
  "meta": {
   "next_token": "abc123"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/twit-sh-list-members-6fd6c58b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from twit.sh](https://www.zero.xyz/host/twit.sh/llms.txt)