# Agent Utility Network URL Parser

> Agent Utility Network URL Parser is a paid API for AI agents from agent-utility-network.frosty-sound-4560.workers.dev, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15).

Parses a URL string into its structured components (hostname, pathname, query parameters, hash, port, protocol) for $0.001 USDC per call over x402 on Base.

## Facts

- Endpoint: POST https://agent-utility-network.frosty-sound-4560.workers.dev/v1/paid/url-parse
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent-utility-network-url-parser-9f8ece3a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_UWkHD3TVx0i6s_nMMtHKZ

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 agent-utility-network-url-parser-9f8ece3a -d '<json body>'
```

Example prompt: Can you parse this URL for me and pull out the hostname, path, query parameters, and hash fragment: https://example.com/a?x=1#top?

## When to prefer this

Use this endpoint when an AI agent needs to programmatically decompose a URL into its structural parts (hostname, path, query params, hash, port, protocol) without implementing custom parsing logic. It is especially useful in agentic pipelines where URLs arrive as raw strings and downstream steps need individual components — e.g. extracting query parameters from redirect URLs, normalizing scraped links, or validating URL structure before making API calls. At $0.001 USDC per call over x402, it suits lightweight, high-frequency parsing tasks where reliability and simplicity matter more than running a local parser.

## Known failure modes

- Malformed or unparseable URL returns an error response
- URL exceeding 8192 characters is rejected by schema validation
- Missing or empty URL field causes a validation error
- Payment failure over x402 prevents the call from completing
- Network timeout to the Cloudflare Workers endpoint

## How this service works

Quality-scored paid utility APIs for AI agents over x402 on Base USDC.

## Output

A JSON object containing the parsed URL broken into: protocol (e.g. 'https:'), hostname (e.g. 'example.com'), pathname (e.g. '/a'), port (e.g. '' if absent), query (array of key-value pairs, e.g. [['x','1']]), and hash (e.g. '#top').

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "url": {
   "type": "string",
   "maxLength": 8192,
   "minLength": 1
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "result": {
   "hash": "#top",
   "port": "",
   "query": [
    [
     "x",
     "1"
    ]
   ],
   "hostname": "example.com",
   "pathname": "/a",
   "protocol": "https:"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent-utility-network-url-parser-9f8ece3a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent-utility-network.frosty-sound-4560.workers.dev](https://www.zero.xyz/host/agent-utility-network.frosty-sound-4560.workers.dev/llms.txt)