# 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 recent tweets for a specific Twitter/X user by their username, optionally including replies

## Facts

- Endpoint: GET https://twitter.surf.cascade.fyi/users/pukerrainbrow/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-9258c6c9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_IH-FOn-fsjup8XfMNJJvq

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-9258c6c9
```

Example prompt: Can you pull the recent tweets from the Twitter account @pukerrainbrow, including their replies?

## When to prefer this

Use this endpoint when you need to programmatically retrieve the tweet history or timeline of a specific Twitter/X user by username. Prefer this over scraping or manual lookup when you need structured tweet data for monitoring, analysis, or aggregation pipelines. Especially useful when you need to optionally filter out replies to get only original posts.

## Known failure modes

- User not found or account suspended — no results returned
- Rate limiting or payment failure — 402 or 429 error
- Private/protected account — tweets not accessible
- Invalid username format — request error
- Network timeout from upstream Twitter API

## How this service works

User tweets

## Output

Returns a list of recent tweets from the specified user's timeline, including tweet text, metadata, and optionally reply tweets depending on the include_replies parameter.

## 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-9258c6c9/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)