# Web Search Advanced (x402 Atlas)

> Web Search Advanced (x402 Atlas) is a paid API for AI agents from websearch.use.x402atlas.com, paid per call via x402, $0.025/call, status unknown (last checked 2026-10-16).

Executes an advanced web search query and returns ranked results with titles, URLs, snippets, and relevance scores, billed per-call via x402 micropayments.

## Facts

- Endpoint: GET https://websearch.use.x402atlas.com/search/advanced?utm_source=zero.xyz
- Price: $0.025/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/web-search-advanced-x402-atlas-13b05731
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_sQDp7-ej2ZX1VgM73UvX3

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 web-search-advanced-x402-atlas-13b05731
```

Example prompt: Search the web for the latest developments in quantum computing hardware and give me the top results with their URLs and summaries.

## When to prefer this

Choose this endpoint when you need live, ranked web search results with relevance scores and page snippets from the open internet, especially for current events, news, or rapidly changing topics where a static knowledge base would be stale. It is ideal for AI agents that need to pay per-query without a subscription and operate on Base, Polygon, or Arbitrum using USDC micropayments via the x402 protocol. Prefer alternatives if you need bulk/batch searches, deep crawling of a specific site, or structured data extraction from known URLs.

## Known failure modes

- Missing or empty 'query' parameter returns a 400 validation error
- No payment header returns a 402 challenge with payment requirements
- Insufficient USDC balance or invalid payment signature returns a 402 rejection
- Query string exceeding 1000 characters returns a validation error
- Upstream search provider unavailability results in a 502 or 503 error
- Malformed query with no meaningful terms may return zero results

## How this service works

Deep web research for AI agents — advanced search returning the highest-relevance results with multiple query-focused snippets per source, plus an optional LLM-generated answer grounded in the returned sources when include_answer is set. One-call research assistant for high-precision queries; news and finance topics, date and domain filters.

## Output

A JSON object containing the normalized query string, a timestamp of when the search was executed (UTC), and an array of ranked results — each with a title, URL, a relevant content snippet, and a numerical relevance score. Optionally includes a full cleaned page body and an LLM-generated answer grounded in results when those options are enabled.

## 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": "The search query to execute"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "queried_at",
      "query",
      "results"
     ],
     "properties": {
      "note": {
       "type": "string",
       "description": "Present only on a sample response (empty/omitted query): a hint to pass a real query. The paid request ran; no upstream call was made."
      },
      "query": {
       "type": "string",
       "description": "The upstream-normalized query that was executed"
      },
      "answer": {
       "type": "string",
       "description": "LLM-generated answer grounded in the results (only when include_answer was set)"
      },
      "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"
         },
         "raw_content": {
          "type": "string",
          "description": "Cleaned full page content (only when include_raw_content was set)"
         }
        }
       }
      },
      "queried_at": {
       "type": "string",
       "format": "date-time",
       "description": "Time the search was executed (UTC)"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "query": "latest developments in AI agents",
  "results": [
   {
    "url": "https://example.com/ai-agents-2026",
    "score": 0.87,
    "title": "AI agents in 2026: what changed",
    "content": "A short, relevant snippet from the page..."
   }
  ],
  "queried_at": "2026-07-01T12:00:00Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/web-search-advanced-x402-atlas-13b05731/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)
