# MapleAI X/Twitter Search

> MapleAI X/Twitter Search is a paid API for AI agents from base.mapleai.shop, paid per call via x402, $0.031/call, status unknown (last checked 2026-10-11).

Searches X/Twitter posts by query with optional web search, returning AI-summarized results or structured post arrays, paid per-request in USDC via x402.

## Facts

- Endpoint: POST https://base.mapleai.shop/v1/x/search?utm_source=zero.xyz
- Price: $0.031/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/mapleai-x-twitter-search-ada7f543
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Ksyi6HFmHfYLNM_onb9wt

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 mapleai-x-twitter-search-ada7f543 -d '<json body>'
```

Example prompt: Search X for posts about the Bitcoin ETF approval from the last 48 hours, return up to 15 results as a structured JSON array with URLs and engagement counts, and also run a web search alongside it.

## When to prefer this

Choose this endpoint when you need real-time or recent X/Twitter post data with AI summarization and optional web augmentation, especially when structured citation output (JSON with engagement metrics) is needed. Prefer over general web search when X-specific social signals, tweet engagement data, or author attribution matter. Best for brand monitoring, news pulse checks, and trend tracking within a rolling 7-day window.

## Known failure modes

- Query string exceeds 2000 characters — validation error
- hours_back exceeds 168 (7 days) — clamped or rejected
- Payment not accepted / USDC balance insufficient via x402 — 402 Payment Required
- X-side rate limiting or no results found for narrow queries — empty citations array
- Invalid format enum value — schema validation error

## How this service works

14 chat models (GPT + Claude), 7 image models, and Jev structured decisions. Pay per request in USDC on Base with x402.

## Output

Returns either a prose AI-generated summary of relevant X posts with citation URLs, or a validated JSON array of up to 25 posts each containing URL, author, date, text, likes, and reposts — plus input/output token usage stats.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "query": {
   "type": "string",
   "description": "What to look for on X/Twitter, 1-2000 characters"
  },
  "format": {
   "enum": [
    "text",
    "json"
   ],
   "type": "string",
   "default": "text",
   "description": "json returns a validated posts array {url, author, date, text, likes, reposts} instead of a prose summary"
  },
  "hours_back": {
   "type": "integer",
   "maximum": 168,
   "minimum": 1,
   "description": "Restrict search to the last N hours (date filter on the X side)"
  },
  "include_web": {
   "type": "boolean",
   "default": false,
   "description": "Also run a web search alongside X"
  },
  "max_results": {
   "type": "integer",
   "default": 10,
   "maximum": 25,
   "minimum": 1,
   "description": "Maximum posts cited"
  },
  "instructions": {
   "type": "string",
   "description": "Optional extra instructions for the search agent"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "usage": {
   "input_tokens": 1200,
   "output_tokens": 300
  },
  "object": "response",
  "citations": [
   "https://x.com/user/status/123"
  ],
  "output_text": "..."
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/mapleai-x-twitter-search-ada7f543/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from base.mapleai.shop](https://www.zero.xyz/host/base.mapleai.shop/llms.txt)