Updating from API version 1
API version 1 is now deprecated, but it's still available. API version 1 returned the ID of the short link (e.g.
). API version 2 now returns the whole short link (e.g.
Urly APIs version 2
It is possible to interface Urly with other services and applications using the following API set. You'll need a secret API key that you can request for free, contact us
In order to create a shortened link, you have to supply the following URL:
in which KEY is your own secret key and ADDRESS is the original long URL that you want to shorten (the leading
in the URL to be shortened isn't mandatory).
The output is served in plain text (
) and it's the shortened link URL. For example:
An error code is preceded by the underscore symbol
and can be one of the following list:
|_NO_API_KEY||You didn't pass your secret key using |
|_BANNED_API_KEY||The key you passed doesn't exist or it was banned from Urly.|
|_NO_API_VERSION||You didn't pass the API version using |
|_UPDATE_API||The API version you're using is not available anymore. You need to update your application.|
|_NO_URL ||You didn't pass any URL to shorten.|
|_INVALID_URL||You passed a wrong or malformed URL.|
|_ANTIFLOOD_WAIT||Your application's user must wait some seconds before creating another link.|
|_INVALID_IP||Our servers could not detect the user's IP address. The link can't be shortened for security reasons.|
|_INTERNAL_ERROR||Generic internal error. We couldn't shorten your link.|