Skip to content
POST AI agent ready /v1/url/decode

URL Decode API - Free Percent-Decoding

Converts a percent-encoded string back to its original form. Decodes %20 to spaces, %26 to &, and all other RFC 3986 escape sequences.

Parameters

stringrequired

The percent-encoded string to decode.

Code examples

curl -X POST https://api.botoi.com/v1/url/decode \
  -H "Content-Type: application/json" \
  -d '{"text":"hello%20world%20%26%20goodbye%3Dtest"}'

When to use this API

Reading query parameters from logs

Decode percent-encoded URLs found in server logs to make them human-readable for debugging.

Processing OAuth callback URLs

Decode the state or redirect_uri parameter from an OAuth callback before routing the user.

Frequently asked questions

Does this decode + as a space?
Yes. The API decodes both %20 and + as spaces, covering both RFC 3986 and form-encoded formats.
What happens with invalid percent sequences?
Invalid sequences like %ZZ are left as-is in the output rather than throwing an error.
Can I decode a full URL with path and query?
Yes. Pass the entire URL string and the API decodes all percent-encoded sequences within it.
Is the output UTF-8?
Yes. Percent-encoded bytes are decoded as UTF-8, supporting international characters and emoji.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.