# ONE Engine URL Component Parser

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

Parses a URL string into its constituent components: protocol, hostname, pathname, search query, and hash fragment.

## Facts

- Endpoint: POST https://one-search.one-engine.workers.dev/v1/url/components?utm_source=zero.xyz
- Price: $0.0011/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-url-component-parser-9a98cdd5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_wEi4Y29SVbGrY9imgdhRo

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-url-component-parser-9a98cdd5 -d '<json body>'
```

Example prompt: Can you break down this URL into its components — protocol, hostname, path, query string, and hash — for https://example.com/path?q=1#top?

## When to prefer this

Choose this endpoint when you need a simple, cheap, pay-per-call URL decomposition without standing up your own parsing infrastructure. It is ideal for autonomous agents running on Base via x402 that need to inspect individual URL parts at low cost ($0.0011 USDC per call). Prefer this over client-side parsing when the agent environment does not have a native URL parser available, or when you want a consistent serverside extraction step in a pipeline.

## Known failure modes

- Malformed or non-parseable URL input may return an error or empty fields
- Missing required 'url' field in request body returns a 400-level error
- Relative URLs without a protocol may parse incorrectly or fail
- Very long or unusual URL encodings may produce unexpected results

## How this service works

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

## Output

A JSON object containing five fields: protocol (e.g. 'https:'), hostname (e.g. 'example.com'), pathname (e.g. '/path'), search (e.g. '?q=1'), and hash (e.g. '#top'). Each field corresponds to a standard URL component as defined by the browser URL API.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "hash": "#top",
  "search": "?q=1",
  "hostname": "example.com",
  "pathname": "/path",
  "protocol": "https:"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/one-engine-url-component-parser-9a98cdd5/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)