# ReadX Mentions Timeline API

> ReadX Mentions Timeline API 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 paginated list of tweets that mention a specific X/Twitter user, returning tweet text, author, likes, and pagination cursors

## Facts

- Endpoint: GET https://readx.sh/api/%7Bname%7D/mentions
- 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-mentions-timeline-api-20c1fc91
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_3KRP2Q3P5q7eH55heaNsq

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-mentions-timeline-api-20c1fc91
```

Example prompt: Can you pull all the recent tweets mentioning @elonmusk on X and show me who's talking about him, including their tweet text and how many likes each got? Paginate through all results until there are no more.

## When to prefer this

Use this endpoint when you need to retrieve tweets mentioning a specific X/Twitter user without setting up OAuth or X API keys, and when you want to pay per call via USDC micropayments. Prefer this over direct X API access when you need a simple REST JSON interface with no authentication setup overhead. Ideal for social listening, brand monitoring, and mention tracking workflows.

## Known failure modes

- Unknown or suspended username returns empty results or 404
- Invalid or expired cursor causes pagination to restart or return error
- Username with private account returns no tweets
- Rate limiting or upstream X API unavailability returns 5xx
- Payment failure (insufficient USDC balance) returns 402 before data is returned

## 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 containing an array of tweets that mention the specified user, each with tweet ID, text content, author username, creation timestamp, and like count. Also includes a has_more boolean and a next_cursor string for paginating through additional results.

## 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": {
   "tweets": [
    {
     "id": "21",
     "card": null,
     "isAI": false,
     "isAd": false,
     "note": null,
     "poll": null,
     "text": "@jack hello",
     "time": 1142974214,
     "user": {
      "id": "99",
      "bio": "",
      "likes": 0,
      "media": 0,
      "banner": "",
      "tweets": 30000,
      "userPic": "",
      "website": "",
      "fullname": "Someone",
      "joinDate": 1142974214,
      "location": "",
      "username": "someone",
      "followers": 599,
      "following": 307,
      "protected": false,
      "suspended": false,
      "pinnedTweet": "0",
      "verifiedType": "Blue"
     },
     "media": null,
     "quote": null,
     "reply": [],
     "stats": {
      "likes": 42,
      "views": 0,
      "quotes": 0,
      "replies": 0,
      "retweets": 0
     },
     "pinned": false,
     "source": "",
     "history": null,
     "replyId": "0",
     "retweet": null,
     "location": "",
     "threadId": "20",
     "available": true,
     "hasThread": false,
     "mediaTags": null,
     "tombstone": "",
     "attribution": null
    }
   ]
  },
  "pagination": {
   "has_more": true,
   "next_cursor": "DAABCgABG...cursor"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/readx-mentions-timeline-api-20c1fc91/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)