# Twitter Surf Batch User Fetch

> Twitter Surf Batch User Fetch 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-15).

Batch fetch multiple Twitter/X user profiles by their user IDs in a single request

## Facts

- Endpoint: GET https://twitter.surf.cascade.fyi/users
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/twitter-surf-cascade-fyi-ead4278e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Ud3feKrK9FOLphgOoRulo

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

Example prompt: Can you look up the Twitter profiles for these user IDs all at once: 12345678, 87654321, and 11223344?

## When to prefer this

Use this endpoint when you need to resolve or enrich multiple Twitter/X user IDs into full profile data in a single call, avoiding the overhead of making one request per user. Ideal for pipelines that collect user IDs from follower lists, mention streams, or other sources and need to hydrate them into profile objects efficiently.

## Known failure modes

- Missing or empty 'ids' query parameter returns a validation error
- Invalid or malformed user IDs may return partial results or errors for those IDs
- Rate limiting or payment failure (x402) returns 402 Payment Required
- Non-existent user IDs return empty or null entries for those IDs
- Too many IDs in a single batch may exceed service limits

## How this service works

Pay-per-use Twitter/X data API with x402 micropayments.

## Output

Returns an array of Twitter/X user profile objects corresponding to the requested user IDs, including metadata such as display names, usernames, bios, follower counts, and other profile fields available via the Twitter Surf proxy.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "ids": "123456789,987654321,555666777"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": [
   {
    "id": "44196397",
    "name": "Elon Musk",
    "username": "elonmusk"
   }
  ],
  "meta": {
   "result_count": 2,
   "has_next_page": false
  }
 }
}
```

## More

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