# ONE Engine Query Parse

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

Parses a natural language or structured query string into its component parts (key-value pairs and arrays) for downstream processing by autonomous agents.

## Facts

- Endpoint: POST https://one-search.one-engine.workers.dev/v1/query/parse?utm_source=zero.xyz
- Price: $0.001/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-query-parse-5973446f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_EWmfWEFP9XKVdaLzTOXRn

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-query-parse-5973446f -d '<json body>'
```

Example prompt: Parse this query into its structured components: 'blue running shoes size 10 under $100 near me' — I need the individual fields and values separated out.

## When to prefer this

Use this endpoint when you need to decompose a raw user query string into structured key-value components at very low cost ($0.001 USDC per call) and high speed. It is ideal for agent pipelines that need to route, filter, or parameterize downstream API calls based on user intent expressed as free text. Prefer this over in-context LLM parsing when you want a deterministic, cheap, pay-per-call utility without burning LLM tokens.

## Known failure modes

- Empty or missing query field returns an error or empty parse result
- Highly ambiguous queries may produce malformed or incomplete key-value decomposition
- Non-English or heavily idiomatic queries may parse incorrectly
- Payment failure via x402 returns 402 status before any parsing occurs
- Very long or complex queries may exceed processing limits

## How this service works

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

## Output

A JSON object containing parsed query components as key-value pairs and arrays — for example, extracted attributes, filters, terms, and named entities derived from the input query string.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "query": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "value": {
   "a": "1",
   "b": [
    "hello",
    "world"
   ]
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/one-engine-query-parse-5973446f/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)