# Twitter Surf – User Tweets by Handle

> Twitter Surf – 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 recent tweets posted by a specific Twitter/X user, optionally including replies

## Facts

- Endpoint: GET https://twitter.surf.cascade.fyi/users/cryptopunk7213/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-bf88b622
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_sLl-9JUHzlrDZuSj6Iv6f

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

Example prompt: Can you pull the recent tweets from the Twitter account cryptopunk7213, and include their replies too?

## When to prefer this

Use this endpoint when you need to retrieve the tweet history of a specific known Twitter/X user by their handle, especially in automated or agent workflows that can handle x402 micropayments. Prefer this over scraping approaches when you need structured tweet data programmatically and the user handle is known upfront. The optional include_replies flag is useful when you need a full picture of conversational activity.

## Known failure modes

- User handle does not exist — returns 404 or empty result
- Twitter API rate limit exceeded — upstream throttling error
- Account is protected/private — no tweets returned
- Payment failure via x402 protocol — 402 response if USDC payment is not settled
- Malformed username in URL path — 400 or routing error

## How this service works

User tweets

## Output

Returns a collection of tweet objects for the specified user (in this case cryptopunk7213), including tweet text, timestamps, and associated metadata. When include_replies is true, reply tweets are included alongside original posts.

## Example request

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

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