# Bulk Web Search (Multi-Query)

> Bulk Web Search (Multi-Query) is a paid API for AI agents from websearch.use.x402atlas.com, paid per call via x402, $0.045/call, status unknown (last checked 2026-10-29).

Run up to 5 web search queries in a single paid API call, returning ranked results (title, URL, snippet, relevance score) per query as structured JSON.

## Facts

- Endpoint: GET https://websearch.use.x402atlas.com/search/bulk?utm_source=zero.xyz
- Price: $0.045/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/bulk-web-search-multi-query-ec3e8f60
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_2pNRM0alNt7WQsW8iRQyW

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 bulk-web-search-multi-query-ec3e8f60
```

Example prompt: Search the web for all five of these topics at once and give me ranked results for each: 'LLM agent frameworks 2025', 'RAG pipeline best practices', 'vector database comparison', 'AI agent memory architectures', and 'multi-agent orchestration tools'.

## When to prefer this

Choose this endpoint when you need to run 2–5 distinct web searches as part of a single agent workflow step — such as research fan-out, multi-query RAG retrieval, or parallel topic comparison — and want to pay once instead of making multiple separate calls. It is more cost-efficient and faster than chaining individual search calls when the queries are independent. Prefer the single-query endpoint if you only have one search to perform, or the deep research endpoint if you need higher-depth crawling per query.

## Known failure modes

- Upstream search failure for one or more queries — those queries appear in 'failed_queries' array while successful ones are returned normally
- Empty results array for a query if no relevant pages were found
- Payment not processed — x402 payment required before results are returned
- Query string exceeds 1000 characters — validation error
- More than 5 queries submitted — exceeds the per-call limit
- Rate limiting or upstream provider downtime causing all queries to fail

## How this service works

Bulk web search — run up to 5 search queries in one paid call and get ranked results per query (title, URL, snippet, relevance score) as clean JSON. Same news, finance, date-range, country and domain filters as single web search, applied to every query. One payment instead of five for research fan-out, multi-query RAG retrieval and agent planning.

## Output

A JSON object containing a 'searches' array with one entry per submitted query (in submission order), each holding the query string and an array of results. Each result includes title, URL, content snippet, and a numerical relevance score. A 'queried_at' ISO datetime is included, plus an optional 'failed_queries' array listing any queries that failed upstream.

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "query"
     ],
     "properties": {
      "query": {
       "type": "string",
       "maxLength": 1000,
       "description": "Repeat the parameter per query, 1..5 (?query=a&query=b); each up to 1000 chars"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "queried_at",
      "searches"
     ],
     "properties": {
      "note": {
       "type": "string",
       "description": "Present only on a sample response (no query): a hint to pass real queries. The paid request ran; no upstream call was made."
      },
      "searches": {
       "type": "array",
       "items": {
        "type": "object",
        "required": [
         "query",
         "results"
        ],
        "properties": {
         "query": {
          "type": "string"
         },
         "results": {
          "type": "array",
          "items": {
           "type": "object",
           "required": [
            "title",
            "url",
            "content",
            "score"
           ],
           "properties": {
            "url": {
             "type": "string"
            },
            "score": {
             "type": "number",
             "description": "Relevance score"
            },
            "title": {
             "type": "string"
            },
            "content": {
             "type": "string",
             "description": "Relevant snippet from the page"
            }
           }
          }
         }
        }
       },
       "description": "One entry per successful query, in submission order"
      },
      "queried_at": {
       "type": "string",
       "format": "date-time"
      },
      "failed_queries": {
       "type": "array",
       "items": {
        "type": "string"
       },
       "description": "Queries whose search failed upstream; absent when all succeeded"
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/bulk-web-search-multi-query-ec3e8f60/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from websearch.use.x402atlas.com](https://www.zero.xyz/host/websearch.use.x402atlas.com/llms.txt)