# Web Search with SERP Results & Optional LLM Answer

> Web Search with SERP Results & Optional LLM Answer is a paid API for AI agents from websearch.use.x402atlas.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Executes a real-time web search query and returns ranked SERP-style results as structured JSON, with optional LLM-generated answer synthesis.

## Facts

- Endpoint: GET https://websearch.use.x402atlas.com/search
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/web-search-with-serp-results-optional-llm-answer-3822d417
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_HCwVwNelLKzHYgfUyExX0

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-with-serp-results-optional-llm-answer-3822d417
```

Example prompt: Search the web for the latest news about OpenAI's newest model release and give me a ranked list of results with a short answer summarizing what you find.

## When to prefer this

Choose this endpoint when you need real-time, up-to-date web search results that go beyond LLM training data cutoffs — especially for current events, breaking news, live financial data, or recent product information. Prefer this over static knowledge retrieval when freshness matters, and over raw URL fetching when you need ranked discovery across multiple sources rather than content from a known URL.

## Known failure modes

- Empty query string returns a 400 error
- Query exceeding 1000 characters is rejected
- No results found for highly niche or misspelled queries returns an empty results array
- Network timeouts or upstream search provider outages return 5xx errors
- Rate limiting or insufficient payment balance returns a 402 Payment Required error

## How this service works

Real-time web search for AI agents — search the web and get ranked SERP-style results as clean JSON: title, URL, snippet, relevance score, optional LLM-generated answer. Find up-to-date information online — latest news, current events, finance. Date, domain and exact-phrase filters.

## Output

A JSON object containing the normalized query string, a UTC timestamp of when the search ran, an array of ranked results (each with title, URL, snippet/content, and relevance score), and optionally an LLM-generated answer grounded in those results when requested.

## 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-with-serp-results-optional-llm-answer-3822d417/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)