# X402 Twitter/X Search API

> X402 Twitter/X Search API is a paid API for AI agents from x.1x402.sh, paid per call via x402, $0.03/call, status down (last checked 2026-10-18).

Search tweets and X/Twitter content via a pay-per-call JSON API using x402 micropayments, no API keys required

## Facts

- Endpoint: GET https://x.1x402.sh/api/search?utm_source=zero.xyz
- Price: $0.03/call
- Payment: x402
- Status: down
- Last checked: 2026-10-18
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-twitter-x-search-api-fb33231b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_4mPrinGtFYJlE4gEc1T75

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 x402-twitter-x-search-api-fb33231b
```

Example prompt: Search X/Twitter for recent tweets about 'AI agents' and show me what people are saying — pay the $0.05 per call fee automatically using USDC on Base.

## When to prefer this

Use this endpoint when you need to search X/Twitter content without obtaining official Twitter API credentials, want to pay only per call (no monthly subscription), and are operating in an environment that supports x402 USDC micropayments on Base. Ideal for AI agents that need ad-hoc Twitter search without API key management overhead.

## Known failure modes

- Payment not included or insufficient USDC — returns 402 Payment Required
- Invalid or missing search query parameter — returns error with code field
- X/Twitter upstream rate limiting or downtime — returns error in data field
- Query returns no results — empty data object returned with code 0
- Network timeout from upstream X API

## How this service works

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

## Output

Returns a JSON object with a status code and a data payload containing tweet search results matching the query, including tweet content, metadata, and related user information from X/Twitter.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "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/x402-twitter-x-search-api-fb33231b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x.1x402.sh](https://www.zero.xyz/host/x.1x402.sh/llms.txt)