# 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 (clawdbotatg), optionally including replies

## Facts

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

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

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

## When to prefer this

Use this endpoint when you need to retrieve recent tweets for the specific hardcoded user 'clawdbotatg' via the twitter.surf.cascade.fyi service with x402 micropayment support. Prefer this over scraping or direct Twitter API calls when you want a pay-per-use model without managing OAuth credentials.

## Known failure modes

- User account does not exist or is suspended — likely returns 404 or empty result
- Account is private/protected — may return empty or restricted response
- Payment of 0.004 USDC not fulfilled — returns 402 Payment Required
- Rate limiting or quota exceeded — returns 429 or error response
- Twitter API upstream outage — returns 5xx error

## How this service works

User tweets

## Output

A list of tweets from the specified Twitter user account, potentially including reply tweets if the include_replies flag is set. Each tweet likely includes tweet text, timestamps, and related metadata.

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