# ONE Engine URL Encoder

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

URL-encodes a plain text string into percent-encoded format suitable for use in HTTP URLs

## Facts

- Endpoint: POST https://one-search.one-engine.workers.dev/v1/url/encode?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-encoder-5bb0585f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_kcmyVR2wCOhy4jL9T1Awn

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-encoder-5bb0585f -d '<json body>'
```

Example prompt: Can you URL-encode the text 'hello world?' so I can safely embed it in a URL query string?

## When to prefer this

Use this endpoint when an AI agent needs a quick, pay-per-call URL encoding operation without standing up its own encoding library, particularly in serverless or constrained environments where external utility calls are acceptable and the x402 micropayment model on Base is already in use.

## Known failure modes

- Missing or empty 'text' field in request body may return an error or empty result
- Payment failure via x402 if USDC balance is insufficient (HTTP 402)
- Malformed JSON request body returns a 4xx error
- Extremely large input strings may be rejected or time out

## How this service works

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

## Output

A JSON object containing a single field 'text' with the percent-encoded version of the input string, where spaces become %20, question marks become %3F, and other reserved characters are similarly escaped.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "text": "hello%20world%3F"
 }
}
```

## More

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