# MapleAI Web Search

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

Performs an AI-powered web search and returns a synthesized answer with cited sources, paid per request in USDC via x402.

## Facts

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

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-web-search-1a300ef5 -d '<json body>'
```

Example prompt: Search the web for the latest news on Ethereum ETF approvals, return up to 15 sources, and only look at coindesk.com and cointelegraph.com.

## When to prefer this

Choose this endpoint when you need a synthesized, cited answer grounded in current web content and are willing to pay per-query in USDC. It is ideal for agents that need up-to-date information not in a training set, or when results must be restricted to trusted domains. Prefer it over static knowledge bases when freshness and citations matter.

## Known failure modes

- Query exceeds 2000 character limit — request rejected
- max_results above 25 or below 1 — validation error
- Payment not included or insufficient USDC — 402 Payment Required
- allowed_domains list exceeds 5 entries — request rejected
- Network or upstream search provider unavailable — 5xx 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 a JSON object containing a synthesized answer text based on web search results, a list of citation URLs used as sources, and token usage statistics (input and output token counts).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "query": {
   "type": "string",
   "maxLength": 2000
  },
  "max_results": {
   "type": "integer",
   "default": 10,
   "maximum": 25,
   "minimum": 1,
   "description": "Sources cited; drives the price"
  },
  "instructions": {
   "type": "string",
   "description": "Optional extra instructions for the search agent"
  },
  "allowed_domains": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "maxItems": 5,
   "description": "Restrict search to these domains (e.g. [\"coindesk.com\"])"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "usage": {
   "input_tokens": 900,
   "output_tokens": 250
  },
  "object": "response",
  "citations": [
   "https://example.com/article"
  ],
  "output_text": "..."
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/mapleai-web-search-1a300ef5/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)