# Twitter Surf - User Tweets by Username

> Twitter Surf - User Tweets by Username is a paid API for AI agents from twitter.surf.cascade.fyi, paid per call via x402, $0.004000/call, status unknown (last checked 2026-09-14).

Retrieves tweets posted by a specific Twitter/X user, with optional inclusion of replies

## Facts

- Endpoint: GET https://twitter.surf.cascade.fyi/users/kathkirkbos/tweets
- Price: $0.004000/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-b8d19828
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_AewMo81tXBoUlaLpOnX_u

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

Example prompt: Can you pull the recent tweets from the Twitter account @kathkirkbos, including any replies they've posted?

## When to prefer this

Use this endpoint when you need to programmatically fetch tweets from a specific public Twitter/X user by their username handle, especially in automated agent workflows that require paying per call via the x402 protocol. Prefer this over scraping when you need structured tweet data with optional reply filtering.

## Known failure modes

- User account not found or handle doesn't exist — returns error or empty result
- User account is private/suspended — access denied or empty response
- Rate limiting or upstream Twitter API restrictions — may return partial or no data
- Payment failure via x402 protocol — endpoint not accessible without valid payment
- Invalid or missing username in path — returns error

## How this service works

User tweets

## Output

A list of tweets from the specified user, including tweet text, timestamps, and optionally reply tweets if include_replies is set to true.

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

## More

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