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

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

## Facts

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

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

Example prompt: Can you pull the latest tweets from the X account alexkarn13, and include their replies too?

## When to prefer this

Use this endpoint when you need to retrieve a specific user's recent tweets by their exact Twitter/X username. It is ideal for monitoring a known account's public activity, extracting tweet text and engagement metrics, or building a feed of a user's posts. Prefer this over search-based endpoints when you know the target username and want their personal tweet timeline rather than keyword-matched results.

## Known failure modes

- User not found or account suspended — likely returns empty data or 404-level error
- Rate limiting or quota exceeded — payment processed but no data returned
- Username path param missing or malformed — request fails validation
- Private/protected account — tweets not accessible publicly
- Network timeout or upstream Twitter API unavailability

## How this service works

User tweets

## Output

Returns an array of tweet objects for the specified user, each containing the tweet ID, URL, text content, language, timestamp, source app, public engagement metrics (likes, retweets, replies, impressions), author profile details (name, username, verification status, follower counts), referenced tweets, conversation ID, and any entities like mentions. A time_ago field provides human-readable recency. Replies can be included or excluded via a query 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"
    },
    "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"
    }
   }
  }
 }
}
```

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