# ReadX — X/Twitter User Timeline with Media

> ReadX — X/Twitter User Timeline with Media 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 a Twitter/X user's timeline filtered to tweets containing media, returning JSON data via pay-per-call micropayment

## Facts

- Endpoint: GET https://readx.sh/api/%7Bname%7D/with_media
- 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-x-twitter-user-timeline-with-media-363a958f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Im0yKnXL4ydHMwZ74jdR5

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-x-twitter-user-timeline-with-media-363a958f
```

Example prompt: Can you pull all the recent tweets with photos or videos from the X account @NASA using ReadX — I want to see their media posts in JSON?

## When to prefer this

Use this endpoint when you specifically need tweets that include media (images, videos, GIFs) from a known Twitter/X username, and want to avoid API key management by paying per call with USDC micropayments via x402 on Base or Solana.

## Known failure modes

- Username not found — user does not exist or account is suspended
- Payment failure — insufficient USDC balance or x402 micropayment not processed
- Rate limit or access restriction on the underlying X/Twitter data
- Empty result if user has no media tweets
- Invalid or malformed username parameter returning error response

## 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 a code field (0 for success) and a data object containing tweets from the user's timeline that include media attachments such as images, videos, or GIFs, along with associated tweet metadata.

## 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-x-twitter-user-timeline-with-media-363a958f/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)