API documentation - Create short links with our free API

Developer friends, you can create your own short links for free and without registration with our API.

To use our API, just send a GET request to:

https://shorten.ly/api.php?url=[URL]

Attaching your original link to be shortened as a parameter.

List of available parameters

Name Type Mandatory
url Any URL (Encoded) / max 2000 chars yes
alias Type text 2-30 chars
password Type text 6-30 chars
expiration_date Date format e.g: 2024-12-02 15:00
expiration_hits Max number of hits before link expires
cloak bolean ( yes or no ) / Enable cloaking
facebook_pixel Facebook pixel ID
x_pixel X (Twitter) pixel ID
adword_pixel Adword pixel ID
pinterest_pixel Pinterest pixel ID
linkedin_pixel Linkedin pixel ID
googleanalytics_pixel Google Analytics pixel ID
googletag_pixel Google Tag manager pixel ID
bing_pixel Bing pixel ID
quora_pixel Quora pixel ID
android URL (Encoded) destination for android devices
windows URL (Encoded) destination for Widows devices
mac URL (Encoded) destination for Mac devices
iphone URL (Encoded) destination for (iOS) devices
linux URL (Encoded) destination for linux devices

Example of a full request

https://shorten.ly/api.php?url=https%3A%2F%2Fwww.mylogdomain.com%2Farticle%2Flong-title.html&alias=shorty&expiration_date=2024-12-12 12:00&android=https%3A%2F%2Fplay.google.com%2Fstore%2Fapps%2Fdetails%3Fid%3Dcom.instagram.barcelona

Example of a JSON response

{
    "success":200,
    "response_message":"success",
    "short_url":"https://tin.al/shorty",
    "secret_password":"AhE5zjHYE",
    "creation_date":"2024-12-24 12:00"
}   

Rate Limit.

To ensure the stability of our API and manage unexpected spikes in requests, we have introduced a daily rate limit of 50 short link for unique IP address