# twitter.surf.cascade.fyi – User Tweets by Handle

> twitter.surf.cascade.fyi – User Tweets by Handle 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 identified by their handle (e.g. saylor)

## Facts

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

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

Example prompt: Can you pull the latest tweets from @saylor on Twitter, including any replies he's posted?

## When to prefer this

Use this endpoint when you need to programmatically retrieve tweets from a specific public Twitter/X user by handle, especially when you want to monitor public figures, track commentary, or aggregate social content in an agentic pipeline that supports x402 micropayments. Prefer this over scraping or manual lookup when building automated workflows around Twitter content.

## Known failure modes

- User handle not found or account is private — likely returns 404 or empty result
- Rate limit or payment failure at $0.004 USDC per call — 402 Payment Required if x402 payment not handled
- Invalid or suspended account handle — may return error or empty array
- Network timeout from the upstream Twitter/X API — service unavailable or 503
- Malformed query parameters — 400 Bad Request

## How this service works

User tweets

## Output

A list of recent tweets from the specified user, including tweet text and associated metadata such as timestamps, engagement counts, and optionally reply tweets if include_replies is set to true.

## 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-b4349774/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)