# Twitter Surf - User Mentions

> Twitter Surf - User Mentions 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-10-20).

Retrieves tweets in which the authenticated user has been mentioned on Twitter/X

## Facts

- Endpoint: POST https://twitter.surf.cascade.fyi/users/stable_tweets/mentions?utm_source=zero.xyz
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-20
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/twitter-surf-cascade-fyi-b507cfc1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_YOnnSNn71iZdZe5AIk_HH

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

Example prompt: Can you pull up all the recent tweets where my account has been mentioned on Twitter?

## When to prefer this

Use this endpoint when you need to retrieve tweets that mention the authenticated user on Twitter/X, particularly for monitoring brand mentions, responding to replies, or processing inbound engagement. Prefer this over general tweet search when you specifically want mentions directed at the authenticated account.

## Known failure modes

- Authentication failure — missing or invalid credentials return 401
- Rate limit exceeded — too many requests return 429
- No mentions found — returns empty list
- Invalid pagination cursor — returns error or resets to first page
- Network timeout — service unavailable returns 5xx

## How this service works

Fetches mentions of stable tweets from Twitter-like data.

## Output

A paginated list of tweets in which the authenticated user was mentioned, including tweet content, author details, timestamps, and a cursor for retrieving the next page of results.

## Example request

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

## More

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