# ReadX X/Twitter Search API

> ReadX X/Twitter Search API is a paid API for AI agents from readx.sh, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-23, last successful call 2026-07-23).

Search X/Twitter for tweets and content using a keyword or query string, returning JSON results via pay-per-call micropayments

## Facts

- Endpoint: GET https://readx.sh/api/search?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-23
- Last successful call: 2026-07-23
- Success rate: 100% of calls made through Zero
- Rating: 2.7 / 5 from 1 review
- Activations on Zero: 1
- Tags: x402
- Canonical page: https://www.zero.xyz/c/readx-x-twitter-search-api-fe94013b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_n3inq0QmHAgLCRd_w-ua_

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-search-api-fe94013b
```

Example prompt: Search X/Twitter for recent tweets about 'AI regulation' and show me what people are saying — no API key needed, just pay per call with USDC.

## When to prefer this

Choose this endpoint when you need to search X/Twitter for tweets by keyword, hashtag, or topic without managing X API keys or OAuth credentials. Ideal for agents that need lightweight, pay-as-you-go Twitter search via USDC micropayments on Base or Solana, especially in low-volume or exploratory use cases where a full Twitter API subscription is not warranted.

## Known failure modes

- Invalid or missing search query parameter returns an error response
- Payment not completed via x402 results in 402 Payment Required
- Rate limits or upstream X API restrictions may limit result freshness
- Ambiguous or empty query string may return empty data set
- Network or upstream X/Twitter API downtime causes unavailability

## How this service works

Search tweets. Start the query with @ (or add f:user) to search users instead. Example: GET /api/search?q=typescript

## Output

A JSON response containing tweet search results including tweet content, metadata, author references, and engagement signals, wrapped in a response envelope with a code field and a data object containing the matched 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": {}
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/readx-x-twitter-search-api-fe94013b/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)