# Twitter Surf - User Tweets by Ref

> Twitter Surf - User Tweets by Ref 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 tweets posted by a specific Twitter/X user identified by a ref parameter, with optional inclusion of replies

## Facts

- Endpoint: POST https://twitter.surf.cascade.fyi/users/:ref/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-07d7c97f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_jwh0kDkhWfcg75Bshlu8m

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-07d7c97f -d '<json body>'
```

Example prompt: Can you pull the recent tweets from Twitter user @elonmusk, including their replies, so I can see what they've been posting?

## When to prefer this

Use this endpoint when you need to retrieve tweets from a specific Twitter/X user by their reference identifier, especially when you want to programmatically access tweet history with optional reply filtering. Prefer this over general Twitter search endpoints when you know the specific user you want to monitor or analyze.

## Known failure modes

- User ref not found — returns 404 or empty result
- Invalid or missing ref parameter — returns 400 bad request
- Payment not processed correctly — returns 402 payment required
- Twitter/X API rate limit hit upstream — returns 429 or error
- User account is private or suspended — returns empty or error

## How this service works

Retrieves tweets for a specified user reference.

## Output

A list of tweets from the specified user, potentially including replies depending on the include_replies query parameter. Each tweet likely contains tweet content, timestamps, and associated metadata.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/twitter-surf-cascade-fyi-07d7c97f/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)