# ReadX Tweet Lookup by ID

> ReadX Tweet Lookup 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-12).

Fetches the full JSON data for a single tweet on X/Twitter by its tweet ID, using x402 micropayments instead of API keys

## Facts

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

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-tweet-lookup-by-id-17888b3b
```

Example prompt: Can you pull the full details of this tweet — ID 1234567890123456789 — and tell me what it says, who posted it, and how many likes it has?

## When to prefer this

Use this endpoint when you need tweet data for a known tweet ID without setting up Twitter API credentials, or when you want to pay per call via USDC micropayments on Base or Solana rather than managing API keys and monthly plans. Ideal for agents that occasionally need tweet lookups without committing to a Twitter developer account.

## Known failure modes

- Tweet ID not found or deleted — returns error code in response
- Invalid or malformed tweet ID — API returns error
- Tweet is from a private/protected account — access denied
- x402 payment fails or USDC balance insufficient — 402 Payment Required response
- Rate limit exceeded — server-side throttling

## 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

Returns a JSON object with tweet content including the tweet text, author profile details, timestamp, engagement metrics (likes, retweets, replies), and other tweet metadata wrapped in a response envelope with a status code and data field.

## 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-tweet-lookup-by-id-17888b3b/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)