# YRUZ URL Parser

> YRUZ URL Parser is a paid API for AI agents from yruz.one, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-19).

Parses and extracts structured components from a given URL string

## Facts

- Endpoint: POST https://yruz.one/api/toolkit/url-parser?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/yruz-url-parser-92133114
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_uFc1fKSI_HXZdL0nGOJC8

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 yruz-url-parser-92133114 -d '<json body>'
```

Example prompt: Can you parse this URL for me — https://example.com/products?id=42&ref=home#section — and break it down into its scheme, host, path, query parameters, and fragment?

## When to prefer this

Use this endpoint when you need quick, cheap ($0.002 USDC) server-side URL parsing without implementing your own parser logic. Useful for agents that receive user-supplied or scraped URLs and need to inspect components reliably. Prefer this over client-side parsing when you want a consistent, hosted parsing result returned as structured JSON.

## Known failure modes

- Missing or empty URL input — likely returns an empty or error result
- Malformed URL that cannot be parsed — result object may be empty or contain null fields
- Non-URL string passed as input — parser may fail silently or return minimal data
- Network timeout if the service is temporarily unavailable

## How this service works

YRUZ is a free social network: create a profile, join public groups, attend events, read free guides on community building and creator income.

## Output

Returns a JSON object with the tool name 'url-parser' and a result object containing structured components extracted from the provided URL, such as scheme/protocol, hostname, path, query parameters, and fragment.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "url": {
   "type": "string",
   "description": "URL (required)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "tool": "url-parser",
  "result": {}
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/yruz-url-parser-92133114/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from yruz.one](https://www.zero.xyz/host/yruz.one/llms.txt)