# twitter.surf.cascade.fyi - User Tweets

> twitter.surf.cascade.fyi - User Tweets 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 tweets posted by a specific Twitter/X user (thenarrator), with optional inclusion of replies

## Facts

- Endpoint: GET https://twitter.surf.cascade.fyi/users/thenarrator/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-39cf6641
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Sw2HEJqJvX0yTMHIUWkS_

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-39cf6641
```

Example prompt: Can you grab the recent tweets from thenarrator on Twitter, including their replies?

## When to prefer this

Use this endpoint when you need to retrieve the tweet timeline of the specific user 'thenarrator' via the twitter.surf.cascade.fyi proxy, especially when operating in an x402 micropayment-enabled agent context. Prefer this over scraping when you need clean structured tweet data with optional reply filtering.

## Known failure modes

- User account does not exist or is suspended — likely 404 or empty result
- Account is private — may return empty or error
- Payment not accepted — 402 error if USDC payment fails
- Rate limiting or quota exceeded — 429 error
- Twitter API upstream failure — 503 or gateway error

## How this service works

User tweets

## Output

A list of tweets from the specified Twitter user account (thenarrator), potentially including reply tweets if the include_replies flag is set. Each item likely contains tweet text, metadata, and timestamps.

## 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-39cf6641/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)