staging
Collections / run a short link request

New request

Build the request on the left. Read the answer on the right.

GETyourls.run/
url
alias

The same address always returns the same short link. Add + to a short link to see where it leads.

Usage

yourls.run: a free URL shortener. No sign-up and no API token.

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

    https://www.yourls.run/api?url=https://example.com/a/long/address

From a shell:

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

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

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

As one line of text:

    https://www.yourls.run/api?format=text&url=https://example.com/a/long/address

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

    https://www.yourls.run/<code>         redirects
    https://www.yourls.run/<code>+        the address as text
    https://www.yourls.run/<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.
200 OKexample
{
  "status": "success",
  "url": "https://example.com/some/long/page",
  "keyword": "demo",
  "shorturl": "https://yourls.run/demo",
  "statusCode": 200
}

This is a saved sample. Press Send to make a real link.

Build the request on the left. Read the answer on the right.Free. No sign-up, no key. Links do not expire.