# Twitter Surf – User Following List

> Twitter Surf – User Following List 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 Twitter/X accounts that a specific user is following

## Facts

- Endpoint: GET https://twitter.surf.cascade.fyi/users/blocmates/following
- 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-d71fdb08
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_lLJ5YOzDIcFB51lT-cJHo

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

Example prompt: Can you pull up the list of accounts that @blocmates is following on Twitter? Grab the first page and include a cursor so I can get more.

## When to prefer this

Use this endpoint when you need to retrieve the outbound social graph (accounts followed) for the specific Twitter user 'blocmates' via the twitter.surf.cascade.fyi proxy, especially in contexts where you are paying per-call with x402/USDC and need paginated access to following data without managing direct Twitter API credentials.

## Known failure modes

- User account not found or suspended — likely returns 404 or empty result
- Rate limiting or payment failure — 402 or 429 response
- Invalid or expired pagination cursor — returns error or resets to first page
- Account is private/protected — following list may be inaccessible
- Network timeout or upstream Twitter API unavailability

## How this service works

User following

## Output

Returns a paginated list of Twitter/X user accounts that the specified user (blocmates) is following, including profile data for each followed account and a cursor token for fetching subsequent pages.

## Example request

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

## 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"
    },
    "pathParams": {
     "type": "object"
    },
    "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-d71fdb08/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)