# Twitter/X User Data Lookup by Reference

> Twitter/X User Data Lookup by Reference is a paid API for AI agents from twitter.surf.cascade.fyi, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-14).

Fetches Twitter/X user profile data and details by a user reference identifier

## Facts

- Endpoint: POST https://twitter.surf.cascade.fyi/users/:ref
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/twitter-x-user-data-lookup-by-reference-9bc6951c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_J4OsbseZ--7HnMIkliqwt

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-x-user-data-lookup-by-reference-9bc6951c -d '<json body>'
```

Example prompt: Can you pull up the Twitter profile data for the user @elonmusk — I need their bio, follower count, and account details?

## When to prefer this

Use this endpoint when you need to programmatically fetch structured Twitter/X user profile data by a known user reference (username or ID). Prefer this over scraping or Twitter's official API when you need lightweight, pay-per-call access without OAuth setup. Ideal for enriching user records with social media profile data.

## Known failure modes

- User reference not found — returns 404 or empty result if the username/ID does not exist
- Invalid or malformed user reference — returns error if the ref parameter is not a valid Twitter username or ID
- Rate limiting — endpoint may return 429 if too many requests are made in a short period
- Payment failure — x402 payment of $0.001 USDC not processed correctly results in 402 response
- Twitter/X API downtime — upstream service unavailable causing 503 or timeout

## How this service works

Fetches user data from Twitter/X by reference.

## Output

Returns Twitter/X user profile data including account metadata such as bio, follower count, following count, display name, profile image URL, and other account details for the specified user reference.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/twitter-x-user-data-lookup-by-reference-9bc6951c/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)