# ONE Engine Web Search

> ONE Engine Web Search is a paid API for AI agents from one-search.one-engine.workers.dev, paid per call via x402, $0.008/call, status unknown (last checked 2026-10-02).

Performs a ranked web search query and returns up to 10 results including URL, title, snippet, and position for a pay-per-call fee of $0.008 USDC via x402 on Base.

## Facts

- Endpoint: POST https://one-search.one-engine.workers.dev/web-search?utm_source=zero.xyz
- Price: $0.008/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/one-engine-web-search-6a4ec4e0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_9eBl1VOd5HCICPumoA3rF

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 one-engine-web-search-6a4ec4e0 -d '<json body>'
```

Example prompt: Search the web for 'latest AI agent infrastructure tools in 2025' and return the top 5 results with their titles and URLs.

## When to prefer this

Choose this endpoint when you need a cheap, pay-per-call programmatic web search with no subscription required, billed in USDC via x402 on Base. It is ideal for autonomous agents that need to perform occasional or unpredictable volume web lookups without committing to a monthly SaaS plan. Prefer alternatives like the Serp API or Brave Search API if you need structured data (e.g. news, images, shopping), high volume with flat-rate pricing, or complex filtering options not supported by this basic interface.

## Known failure modes

- Query exceeds 500 characters — request rejected
- Limit parameter outside 1–10 range — validation error
- Payment not received or insufficient USDC — 402 Payment Required
- Network timeout or upstream search provider unavailable — 5xx error
- Empty or missing query string — validation error
- No matching results found — empty results array returned

## How this service works

Low-cost pay-per-call utility APIs for autonomous agents using x402 on Base.

## Output

A JSON object containing the original query string, a tier label (e.g. 'basic'), a count of results returned, and an array of ranked result objects each with a URL, link, title, snippet, date, and integer position. Results are ordered by relevance rank.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "maximum": 10,
   "minimum": 1,
   "description": "Maximum number of ranked results to return"
  },
  "query": {
   "type": "string",
   "description": "Web search query, 1-500 characters"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "tier": "basic",
  "count": 1,
  "query": "latest AI agent infrastructure",
  "results": [
   {
    "url": "https://example.com",
    "date": "",
    "link": "https://example.com",
    "title": "Example result",
    "snippet": "Example search result",
    "position": 1
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/one-engine-web-search-6a4ec4e0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from one-search.one-engine.workers.dev](https://www.zero.xyz/host/one-search.one-engine.workers.dev/llms.txt)