# X API v2 Recent Tweets Search (via simple-x-api.com)

> X API v2 Recent Tweets Search (via simple-x-api.com) is a paid API for AI agents from simple-x-api.com, paid per call via x402, $10/call, status unknown (last checked 2026-10-16).

Proxies the X (Twitter) API v2 /tweets/search/recent endpoint to search for tweets posted in the last 7 days using a query string, with payments handled via x402.

## Facts

- Endpoint: GET https://simple-x-api.com/api/2/tweets/search/recent?utm_source=zero.xyz
- Price: $10/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/simple-x-api-com-43960a95
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_iV6pYQgkUVbA1QmxiZuWP

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 simple-x-api-com-43960a95
```

Example prompt: Search X for tweets mentioning 'OpenAI' posted in the last 7 days and show me the 10 most recent ones with their engagement metrics.

## When to prefer this

Use this endpoint when you need to search recent (last 7 days) tweets on X/Twitter by keyword, hashtag, mention, or complex query operators, without managing your own X developer credentials. Especially suitable for agents that need pay-per-use access without a long-term X API subscription, leveraging x402 crypto micropayments.

## Known failure modes

- Invalid or missing search query returns 400 Bad Request
- Exceeds X API rate limits returns 429 Too Many Requests
- Payment authorization failure if x402 wallet insufficient
- Query uses operators not supported by recent search endpoint
- Time range extends beyond 7-day window for recent search
- Malformed query operators cause syntax error from X API
- No tweets found for query returns empty results array

## How this service works

Proxy the corresponding X API v2 endpoint. x402 authorizes up to $25.00; successful responses settle at X's documented per-resource/per-action price.

## Output

A list of recent tweets (up to 100 per page) matching the search query, including tweet text, author IDs, creation timestamps, and optional public metrics (likes, retweets, replies). Also includes pagination token for fetching additional results. Actual cost settles at X's documented per-resource rate, authorized up to $25 USDC via x402.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {}
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/simple-x-api-com-43960a95/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from simple-x-api.com](https://www.zero.xyz/host/simple-x-api.com/llms.txt)