# ONE Engine URL Host Extractor

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

Extracts the host and hostname components from a given HTTP/HTTPS URL string

## Facts

- Endpoint: POST https://one-search.one-engine.workers.dev/v1/url/host?utm_source=zero.xyz
- Price: $0.0009/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-host-extractor-8436c410
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_pLmM4ytCX8WvGEbP3zrT1

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-host-extractor-8436c410 -d '<json body>'
```

Example prompt: Can you extract the host and hostname from this URL: https://example.com:8443/some/path?query=1 — I need them separated out as structured fields.

## When to prefer this

Choose this endpoint when you need a cheap, fast, agent-friendly way to decompose a URL into its host and hostname components without running a full URL parser locally. It is especially useful in autonomous agent pipelines where you want to offload parsing to a pay-per-call microservice on Base via x402, keeping agent code simple and stateless.

## Known failure modes

- Missing or malformed URL input returns an error
- Non-HTTP/HTTPS schemes (e.g. ftp://, file://) may not be supported
- Empty string input likely returns a parsing error
- Network or worker-side failures may return a 5xx response
- Payment failure via x402 will block the call before execution

## How this service works

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

## Output

Returns a JSON object containing two fields: 'host' (hostname plus port if non-standard, e.g. 'example.com:8443') and 'hostname' (bare domain without port, e.g. 'example.com').

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "host": "example.com:8443",
  "hostname": "example.com"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/one-engine-url-host-extractor-8436c410/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)