# Twitter Surf – User Mentions Feed

> Twitter Surf – User Mentions Feed 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-21).

Retrieves a paginated list of recent mentions for a specified Twitter/X user

## Facts

- Endpoint: GET https://twitter.surf.cascade.fyi/users/llamaai/mentions?utm_source=zero.xyz
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-21
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/twitter-surf-cascade-fyi-9a1c4a41
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Q-3TUwyGo73EtCCBm8Rdb

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-9a1c4a41
```

Example prompt: Can you fetch the latest tweets mentioning @llamaai on Twitter so I can see what people are saying about them recently?

## When to prefer this

Use this endpoint when you need to retrieve mentions of a specific Twitter/X user programmatically, especially for social listening, brand monitoring, or aggregating community feedback. Prefer this over general tweet search when you already know the target username and want mentions specifically directed at that account.

## Known failure modes

- User not found or invalid username — likely 404 or empty result
- Pagination cursor invalid or expired — may return error or restart from beginning
- Rate limiting or payment failure — 402 or 429 response if credits are exhausted
- Private or suspended account — endpoint may return empty or restricted result
- Network timeout on large mention volumes

## How this service works

User mentions

## Output

Returns a paginated list of tweets that mention the specified user, including tweet content and associated metadata. A cursor is provided for fetching subsequent pages.

## Example request

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

## 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": {
      "cursor": {
       "type": "string",
       "description": "Pagination cursor"
      }
     }
    }
   },
   "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-9a1c4a41/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)