# YRUZ URL Encoder

> YRUZ URL Encoder 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).

Encodes a text string into a URL-safe (percent-encoded) format

## Facts

- Endpoint: POST https://yruz.one/api/toolkit/url-encoder?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-encoder-41c48a6d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_0qGla57A3UKyTCZvZtTwU

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-encoder-41c48a6d -d '<json body>'
```

Example prompt: Can you URL-encode this string for me so I can use it safely in a query parameter: 'hello world & welcome to YRUZ!'?

## When to prefer this

Use this endpoint when you need a quick, pay-per-use URL encoding operation without setting up a local library or function. It is suitable for agents that occasionally need to sanitize user-provided strings for URL inclusion without managing encoding logic themselves.

## Known failure modes

- Missing or empty 'text' field returns an error or empty result
- Very long input strings may be truncated or rejected
- Non-UTF-8 encoded input may produce unexpected encoding results
- Network or service unavailability returns a 4xx/5xx HTTP error

## 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

A JSON object with the tool name ('url-encoder') and a result field containing the URL-encoded (percent-encoded) version of the submitted text, with spaces converted to %20 or + and special characters escaped appropriately for safe use in URLs.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "text": {
   "type": "string",
   "description": "input text (required)"
  }
 }
}
```

## Response schema (JSON Schema)

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

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/yruz-url-encoder-41c48a6d/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)