# x402.agentutility.ai Recent Tweet Search

> x402.agentutility.ai Recent Tweet Search is a paid API for AI agents from x402.agentutility.ai, paid per call via x402, $0.006/call, status unknown (last checked 2026-10-15).

Searches recent public tweets on X (Twitter) and returns text, timestamps, public metrics, and author context via X API v2

## Facts

- Endpoint: POST https://x402.agentutility.ai/recent-tweet-search?utm_source=zero.xyz
- Price: $0.006/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-agentutility-ai-recent-tweet-search-b84ad217
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_nALp7q7CTDdDd9MNvUghH

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-agentutility-ai-recent-tweet-search-b84ad217 -d '<json body>'
```

Example prompt: Search recent tweets on X about 'AI agents' from the last 7 days and give me the top posts with their engagement metrics and author info.

## When to prefer this

Use this endpoint when an agent needs read-only access to recent public X/Twitter posts with engagement metrics and author context, settled via USDC micropayment (x402 protocol) without managing X API credentials directly. Prefer it over direct X API integration when you want a pay-per-call model with no API key management, or when the agent runtime supports x402 payment flows natively.

## Known failure modes

- Query too broad returns maximum result cap with truncated coverage
- No results found for niche or very recent queries not yet indexed
- Rate limits from upstream X API v2 cause request failures
- Malformed query syntax (e.g. invalid operators) returns an error
- Payment failure via x402 protocol blocks the request before it reaches the search backend

## How this service works

Repeat a saved recent-tweet search to monitor a brand, topic, or phrase over time. Send the same query, language, and max_results on each check; it returns recent public post text, timestamps, metrics, and expanded author profiles. If native X search cannot answer, the tweets array contains clearly labeled public-index results with degraded: true instead of an empty paid response. Read-only: no posting, replying, liking, following, or direct-message access. Use it as a recent tweet search API, Twitter monitoring API, saved-query watchlist, or X public-post search.

## Output

Returns an array of recent tweet objects, each containing the full tweet text, creation timestamp, public metrics (likes, retweets, replies, impressions), expanded author context (username, display name, follower count), and tweet ID. Results reflect the X API v2 recent search index, covering tweets from approximately the last 7 days.

## 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "required": [
      "query"
     ],
     "properties": {
      "query": {
       "type": "string",
       "description": "X recent-search query."
      },
      "language": {
       "type": "string",
       "description": "Optional two-letter language filter."
      },
      "max_results": {
       "type": "number",
       "description": "Number of recent posts to fetch. Clamped to 10-50. Default 10."
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "mode": {
       "type": "string"
      },
      "source": {
       "type": "string"
      },
      "result_count": {
       "type": "integer"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "mode": "search",
  "source": "X API v2 recent search",
  "result_count": 10
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-agentutility-ai-recent-tweet-search-b84ad217/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.agentutility.ai](https://www.zero.xyz/host/x402.agentutility.ai/llms.txt)