# agent402.tools Multi-Search

> agent402.tools Multi-Search is a paid API for AI agents from agent402.tools, paid per call via x402, $0.08/call, status unknown (last checked 2026-09-14).

Execute 2–5 web searches in a single API call, returning ranked results for each query at a 20% volume discount versus individual searches.

## Facts

- Endpoint: POST https://agent402.tools/api/multi-search
- Price: $0.08/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent402-tools-multi-search-6b05a250
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_e1CP3BdbyUVYoSdvWM3x_

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 agent402-tools-multi-search-6b05a250 -d '<json body>'
```

Example prompt: Search these three things at once and give me the top 5 results for each: 'best electric SUVs 2025', 'Tesla Model Y vs Ford Mustang Mach-E', and 'EV tax credits USA 2025' — and only include results from the past year.

## When to prefer this

Use this endpoint when an agent needs to run 2–5 independent web searches as part of one task — e.g. multi-faceted research, comparing sources, or answering compound questions — and wants to reduce cost (20% discount vs. sequential individual calls) and latency by batching. Prefer this over single-search calls whenever more than one query is needed in the same workflow.

## Known failure modes

- Fewer than 2 or more than 5 queries provided — returns validation error
- Individual query exceeds 400 characters — rejected or truncated
- Invalid freshness value (not pd/pw/pm/py) — may return error or be ignored
- No results found for a specific query — returns empty result list for that query
- Payment not completed or insufficient USDC — 402 Payment Required response

## How this service works

Run 2-5 web searches in one call with a 20% volume discount vs. individual searches. Each query returns ranked results (title, URL, snippet). Ideal for multi-faceted research or comparing sources on different aspects of a topic.

## Output

For each submitted query, returns a ranked list of web results containing the page title, URL, and a text snippet summarizing the content. Results are ordered by relevance and limited to the requested count (1–10 per query, default 5).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "count": {
   "type": "number",
   "description": "Results per query, 1-10 (default 5)"
  },
  "queries": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "description": "Array of 2-5 search queries (each max 400 chars)"
  },
  "freshness": {
   "type": "string",
   "description": "Optional: pd, pw, pm, or py (past day/week/month/year)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "searches": [
   {
    "count": 2,
    "query": "x402 payment protocol",
    "results": [
     {
      "age": null,
      "url": "https://www.x402.org/",
      "title": "x402.org",
      "description": "An open standard…"
     }
    ]
   },
   {
    "count": 2,
    "query": "USDC micropayments",
    "results": [
     {
      "age": null,
      "url": "https://www.circle.com/usdc",
      "title": "Circle USDC",
      "description": "Digital dollar…"
     }
    ]
   }
  ],
  "totalResults": 4
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent402-tools-multi-search-6b05a250/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent402.tools](https://www.zero.xyz/host/agent402.tools/llms.txt)