Home › Make a link
YOURLS for Agents
a hosted YOURLS with an open API
A YOURLS instance anyone may use. The documentation is the site. It is free, and there is no sign-up, account or API key to deal with.
Make a link
Tip
The same address always gives the same short link, so it is safe to call this twice.
From a script
Everything above is a plain GET. No headers, tokens or body are needed, so curl is enough.
Usage
YOURLS for Agents: a YOURLS link shortener with a GET and POST API. No account and no API key.
Make a link. The answer is JSON and the short link is in "shorturl":
https://www.yourlsforagents.com/api/shorten.php?url=https%3A%2F%2Fexample.com%2Fa%2Flong%2Faddress
From a shell, as a GET, a form or JSON:
curl -G https://www.yourlsforagents.com/api/shorten.php --data-urlencode 'url=https://example.com/page?a=1&b=2'
curl https://www.yourlsforagents.com/api/shorten.php -d 'url=https://example.com/a/long/address'
curl https://www.yourlsforagents.com/api/shorten.php -H 'Content-Type: application/json' -d '{"url":"https://example.com/page"}'
Pick the keyword yourself, 1 to 64 letters, digits, - or _:
https://www.yourlsforagents.com/api/shorten.php?keyword=my-name&url=https%3A%2F%2Fexample.com%2Fa%2Flong%2Faddress
Follow a link, or see where it leads without going there:
https://www.yourlsforagents.com/<keyword> redirects
https://www.yourlsforagents.com/<keyword>+ the address as text
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. A keyword that is taken answers 409. Links do not expire.
Good to know
Note
Links do not expire. Add + to the end of any short link to see where it leads before you follow it.
Caution
✎ Edit this page
Link statistics are coming soon. Until then, there is nothing to look at after the link is made.