# ReadX — Fetch Tweets by ID

> ReadX — Fetch Tweets by ID is a paid API for AI agents from readx.sh, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Fetches a specific tweet by its ID for a given X/Twitter username, returning full tweet JSON data via x402 micropayment.

## Facts

- Endpoint: GET https://readx.sh/api/%7Bname%7D/tweets/%7Bid%7D
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/readx-fetch-tweets-by-id-e28b2468
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ZhPt9Tu_ZPos02lQ0XUPn

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 readx-fetch-tweets-by-id-e28b2468
```

Example prompt: Pull the tweet with ID 1234567890123456789 from user elonmusk and give me its full content and engagement stats — no Twitter API key, just pay per call.

## When to prefer this

Use this endpoint when you need to fetch a specific tweet by its ID without managing Twitter API keys or OAuth credentials. Ideal for AI agents that need occasional, on-demand tweet lookups and prefer pay-per-call micropayments over monthly API subscriptions. Best suited when you already know the tweet ID and want full tweet JSON including metadata and engagement data.

## Known failure modes

- Tweet not found or deleted — returns error code with empty data
- Username does not match tweet ID — mismatch error
- Invalid tweet ID format — malformed request error
- Insufficient USDC balance for x402 micropayment — payment failure
- Rate limiting or temporary Twitter data unavailability — service error
- Network timeout — retry with same parameters

## How this service works

ReadX is a read-only X/Twitter JSON API. Profiles, timelines, tweets, search, lists, followers & following — pay per call with x402 micropayments in USDC on Base or Solana. No API keys.

## Output

A JSON object with code 0 and a data field containing the full tweet details including tweet text, author information, timestamps, media attachments, and engagement metrics (likes, retweets, replies) for the requested tweet ID.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "code": 0,
  "data": {}
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/readx-fetch-tweets-by-id-e28b2468/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from readx.sh](https://www.zero.xyz/host/readx.sh/llms.txt)