# Surf Twitter - Tweet by ID

> Surf Twitter - Tweet by ID 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-09).

Fetches a single tweet's text, author, and public engagement metrics by tweet ID via x402 micropayment.

## Facts

- Endpoint: GET https://twitter.surf.cascade.fyi/tweets/%7Bid%7D
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-09
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/surf-twitter-tweet-by-id-9da684f2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_vx8p2fvtarZUo3na53U8K

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 surf-twitter-tweet-by-id-9da684f2
```

Example prompt: Can you fetch the tweet with ID 1585841080431321088 and tell me what it says, who wrote it, and how many likes and retweets it has?

## When to prefer this

Use this endpoint when you need structured tweet data (text, author, engagement metrics) for a specific known tweet ID and want pay-per-use pricing via x402 micropayments rather than managing Twitter API credentials or monthly subscriptions.

## Known failure modes

- Tweet ID not found or deleted — likely returns 404 or empty data
- Invalid tweet ID format — likely returns 400 or error
- Payment failure via x402 micropayment — endpoint returns 402 Payment Required
- Rate limiting or quota exceeded — endpoint may return 429
- Tweet is from a private/suspended account — may return access error

## How this service works

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

## Output

Returns a JSON object with the tweet's ID, full text, author username, and public metrics including like_count and retweet_count.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "id": "1585841080431321088",
   "text": "Hello world",
   "author": {
    "username": "elonmusk"
   },
   "public_metrics": {
    "like_count": 100,
    "retweet_count": 50
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/surf-twitter-tweet-by-id-9da684f2/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)