Urly.it APIs

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: http://urly.it/api.php?apiv=1&apik=KEY&url=ADDRESS in which KEY is your own secret key and ADDRESS is the original long URL that you want to shorten. The leading http:// isn't mandatory.

The output is served in plain text (text/plain) and it's the shortened link ID. For example:
1a The shortened link will be http://urly.it/1a.

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 apik=KEY.
_BANNED_API_KEY	The key you passed doesn't exist or it was banned from Urly. You can contact us to know why your API has been banned.
_NO_API_VERSION	You didn't pass the API version using apiv=1.
_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.