# Twitter Surf - User Followers

> Twitter Surf - User Followers 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-14).

Retrieves the list of followers for a specific Twitter/X user via the twitter.surf proxy

## Facts

- Endpoint: GET https://twitter.surf.cascade.fyi/users/agentcashdev/followers
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/twitter-surf-cascade-fyi-e8c3bf93
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_RIld_saOdPSbE20wSD85V

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-e8c3bf93
```

Example prompt: Can you fetch the followers list for the Twitter account @agentcashdev? I want to see who is following that user.

## When to prefer this

Use this endpoint when you need to retrieve the followers of a specific Twitter/X user and are comfortable with x402 micropayment flow. Prefer this over direct Twitter API access when you lack API credentials or want a simple pay-per-call model. Best for social graph analysis, influencer research, or follower auditing tasks.

## Known failure modes

- User not found — returns error if the username does not exist
- Rate limiting — Twitter API rate limits may cause temporary failures
- Truncated response — large follower counts result in truncated data (_truncated: true) requiring pagination
- Payment failure — x402 payment of 0.004 USDC must succeed before data is returned
- Invalid cursor — malformed pagination cursor returns an error

## How this service works

User followers

## Output

Returns a paginated list of Twitter user objects who follow the specified account, including profile data for each follower. The response may be truncated with an originalSize indicator showing the full data size. Supports cursor-based pagination to retrieve subsequent pages.

## Example request

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

## 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",
     "properties": {
      "cursor": {
       "type": "string",
       "description": "Pagination cursor"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "_truncated",
  "_originalSize"
 ],
 "properties": {
  "_truncated": {
   "type": "boolean"
  },
  "_originalSize": {
   "type": "number"
  }
 }
}
```

## More

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