YOURLS version 1.7.10 is available. Please update now.

How to use YOURLS Link Shortener

No account and no key. Links do not expire, and the same address always gives the same short URL.

YOURLS Link Shortener: a YOURLS you can call without a signature. No account and no API key.

Make a link. The answer is JSON and the short link is in "shorturl":

    https://www.yourlslinkshortener.com/yourls-api.php?action=shorturl&format=json&url=https%3A%2F%2Fexample.com%2Fa%2Flong%2Faddress

From a shell:

    curl -G https://www.yourlslinkshortener.com/yourls-api.php -d action=shorturl -d format=json --data-urlencode 'url=https://example.com/page?a=1&b=2'
    curl https://www.yourlslinkshortener.com/yourls-api.php -d action=shorturl -d format=json -d 'url=https://example.com/a/long/address'

Pick the keyword yourself, 1 to 64 letters, digits, - or _:

    https://www.yourlslinkshortener.com/yourls-api.php?action=shorturl&format=json&keyword=my-name&url=https%3A%2F%2Fexample.com%2Fa%2Flong%2Faddress

See where a link leads:

    https://www.yourlslinkshortener.com/yourls-api.php?action=expand&format=json&shorturl=<keyword>
    https://www.yourlslinkshortener.com/<keyword>+

Follow one:

    https://www.yourlslinkshortener.com/<keyword>

format is json, xml, jsonp (with callback) or simple; xml when it is left out.
Percent-encode url, or put it last: an address written out as it is
runs to the end of the line, with its own ? and & in it.

The same address gives the same short link every time, unless you name
it yourself. Links do not expire.

Back to the form