# URL & Text Tools

URL parsing, RFC 3986 resolution, normalization, percent-encoding, punycode, slugs and tracking-parameter cleanup.

## How to pay

Machine-payable over x402. USDC on: Base (eip155:8453), Solana (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp), Polygon (eip155:137), Arbitrum One (eip155:42161).
No accounts. No API keys. No signup. The paying wallet is the account.

## Machine-readable

- OpenAPI: https://url-text-tools.x402tookit.com/openapi.json
- x402 manifest: https://url-text-tools.x402tookit.com/.well-known/x402
- Catalog (free): https://url-text-tools.x402tookit.com/catalog
- Health (free): https://url-text-tools.x402tookit.com/health
- Uptime (free): https://url-text-tools.x402tookit.com/uptime

## Endpoints (8)

### GET /percent-encode — $0.02
Percent-encode or decode text as URL component, path, query or form data (UTF-8), with byte counts.
Params: text: string, action?: string, mode?: string
Example: https://url-text-tools.x402tookit.com/percent-encode?text=caf%C3%A9+%26+cr%C3%A8me%2F1%2B1%3D2&action=encode&mode=component

### GET /punycode — $0.02
Convert a domain to punycode (xn--) or back to Unicode label by label per RFC 3492, flagging mixed scripts.
Params: domain: string
Example: https://url-text-tools.x402tookit.com/punycode?domain=m%C3%BCnchen.de

### GET /query-string — $0.02
Parse a URL query string into keys and values (repeats grouped) or build one from a JSON object, with duplicates flagged.
Params: query: string, action?: string
Example: https://url-text-tools.x402tookit.com/query-string?query=%3Fa%3D1%26b%3Dtwo%2520words%26a%3D3%26flag&action=parse

### GET /slugify — $0.02
Turn a title into a URL slug: transliterates accents (é, ß, ø), lowercases, trims and caps length at a word break.
Params: text: string, separator?: string, maxLength?: integer, keepCase?: string
Example: https://url-text-tools.x402tookit.com/slugify?text=Caf%C3%A9+Cr%C3%A8me+%26+Stra%C3%9Fe%3A+Ol%C3%A9%21

### GET /tracking-clean — $0.02
Remove utm_*, fbclid, gclid, msclkid and other known tracking parameters from a URL and list what was removed.
Params: url: string
Example: https://url-text-tools.x402tookit.com/tracking-clean?url=https%3A%2F%2Fexample.com%2Fp%3Fid%3D7%26utm_source%3Dnews%26fbclid%3Dabc%26gclid%3D1%23top

### GET /url-normalize — $0.02
Normalize a URL for de-duplication: lowercase scheme/host, drop default port, resolve dot segments, tidy %-escapes.
Params: url: string, sortQuery?: string, dropFragment?: string
Example: https://url-text-tools.x402tookit.com/url-normalize?url=HTTP%3A%2F%2FUser%40Example.COM%3A80%2Fa%2F.%2Fb%2F..%2Fc%2F%257Efoo%2F%25e3%2581%2582%3Fb%3D2%26a%3D1%23x&sortQuery=true

### GET /url-parse — $0.02
Split a URL into scheme, host, port, path, query and fragment per RFC 3986, with warnings. Never fetches the URL.
Params: url: string
Example: https://url-text-tools.x402tookit.com/url-parse?url=https%3A%2F%2Fuser%40Example.com%3A8443%2Fa%2Fb%2F..%2Fc%3Fx%3D1%26y%3D2%23top

### GET /url-resolve — $0.02
Resolve a relative link against a base URL per RFC 3986 section 5, handling ../, ./, //host, ?query and #frag.
Params: base: string, ref: string
Example: https://url-text-tools.x402tookit.com/url-resolve?base=http%3A%2F%2Fa%2Fb%2Fc%2Fd%3Bp%3Fq&ref=..%2Fg

## Terms

URL and text utilities computed locally from published standards (RFC 3986, RFC 3492, WHATWG URL), provided as is. These tools never fetch the URLs they are given and do not judge whether a site is safe. Do not send URLs that contain secrets, tokens or personal data. Not legal or security advice.