how.

Long in. Short out.

Free. No sign-up, no account, no key.

An address that runs past the measure is bad setting. We cannot kern it, so we cut it.

A short link does not expire. Add + to one to see where it leads.

01

UsageThe whole manual. One column.

YOURLS Short: a free URL shortener. No sign-up and no API token.

Make a link. The answer is the short link on one line:

    https://www.yourlsshort.com/?url=https://example.com/a/long/address

From a shell:

    curl -G https://www.yourlsshort.com/shorten --data-urlencode 'url=https://example.com/page?a=1&b=2'
    curl https://www.yourlsshort.com/shorten -d 'url=https://example.com/a/long/address'

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

    https://www.yourlsshort.com/?alias=my-name&url=https://example.com/a/long/address

As JSON:

    https://www.yourlsshort.com/?format=json&url=https://example.com/a/long/address
    curl https://www.yourlsshort.com/shorten -H 'Accept: application/json' -d 'url=https://example.com/page'

Follow a link, or see where it leads without going there:

    https://www.yourlsshort.com/<code>         redirects
    https://www.yourlsshort.com/<code>+        the address as text
    https://www.yourlsshort.com/<code>.json    the address and when the link was made

Put url last, or percent-encode it: 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. A name that is taken answers 409. Links do not expire.
02

NotesSix lines, set solid.

  1. Free. There is no sign-up, no account and no key to ask for.
  2. A short link does not expire.
  3. The same address always gives the same short link.
  4. You may choose the short name yourself.
  5. Add a plus sign to any short link and it shows where it leads instead of going there.
  6. It works from a script with a plain GET. Nothing else is needed.
03