# 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.004/call, status unknown (last checked 2026-09-14).

Fetches the recent tweets posted by a specific Twitter/X user (calebshough) via the twitter.surf proxy, with optional reply inclusion

## Facts

- Endpoint: GET https://twitter.surf.cascade.fyi/users/calebshough/tweets
- 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-f31029e0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_F-JrNJETWj0aP566w6_fQ

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

Example prompt: Can you pull the latest tweets from calebshough on twitter.surf, including their replies?

## When to prefer this

Use this endpoint when you need to programmatically retrieve tweets from the specific user 'calebshough' via the twitter.surf cascade proxy with x402 micropayment billing. Prefer this over scraping or direct Twitter API when you want a pay-per-call model without managing OAuth credentials.

## Known failure modes

- User not found — username calebshough does not exist or has been suspended
- Rate limit exceeded — too many requests to the twitter.surf proxy
- Payment failure — x402 payment of 0.004 USDC not processed
- Empty result — user has no public tweets
- Network timeout — upstream Twitter/X API unavailable

## How this service works

User tweets

## Output

A list of tweet objects from the specified user's timeline, potentially including replies depending on the include_replies parameter. Each tweet likely contains text content, tweet ID, timestamp, and related metadata.

## Example request

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

## 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": {
      "include_replies": {
       "type": "boolean",
       "description": "Include replies"
      }
     }
    }
   },
   "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-f31029e0/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)