# 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).

Fetches the list of Twitter/X accounts that a specific user (joeljohn) is following, with pagination support

## Facts

- Endpoint: GET https://twitter.surf.cascade.fyi/users/joeljohn/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-7cfefec2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_KMLKC7Nk2yJZf3M9s-tkq

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

Example prompt: Can you pull the full list of accounts that joeljohn follows on Twitter using the twitter.surf API? Start from the beginning and give me the first page of results.

## When to prefer this

Use this endpoint when you need to retrieve the list of accounts a specific Twitter user (joeljohn) follows, especially when building social graph analysis, auditing followings, or discovering influencer networks. Prefer this over scraping Twitter directly as it abstracts authentication and handles pagination via cursor.

## Known failure modes

- User not found or account suspended — likely 404 or empty result
- Invalid or expired pagination cursor — may return error or restart from beginning
- Rate limit or payment failure — 402 response requiring payment
- Private/protected account — following list may be inaccessible
- Network timeout or upstream Twitter API unavailability

## How this service works

User following

## Output

A paginated list of Twitter/X accounts that the user joeljohn is following, including profile data for each followed account and a cursor for fetching additional pages.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "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"
    },
    "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-7cfefec2/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)