Link shortening

URL Shortener

To shorten the link, open the file https://cutt.ly/api/api.php remotely (eg via the php file_get_contents), and in the parameters: short enter the address to be shortened (it should be encoded so any special characters will be interpreted correctly), name specify the preferred shortening of the link, userDomain specify if you want to use your own domain, to do so send 1.

Possible parameters

key Your API key. Required
short URL you want to shorten. Required
name Your desired short link if not already taken
userDomain If set to 1, then it will use account's user domain. Check subscription plans for more details - available from Single plan
noTitle noTitle=1
Faster API response time
This parameter disables getting the page title from the source page meta tag which results in faster API response time
Available for Team Enterprise plan
public public=1
Settings public click stats for shortened link via API
Available from Single plan

UTM tags, parameters etc.

The entered link should go through the built-in urlencode() function, then the link parameters will be sent, including UTM tags etc.

Examples

As a reply, json string will be sent, containing following data

url => status: 1 the shortened link comes from the domain that shortens the link, i.e. the link has already been shortened
url => status: 2 the entered link is not a link
url => status: 3 the preferred link name is already taken
url => status: 4 Invalid API key
url => status: 5 the link has not passed the validation. Includes invalid characters
url => status: 6 The link provided is from a blocked domain
url => status: 7 OK - the link has been shortened

If the status is equal to 7, then

url => date date of shortening the link
url => shortLink shortened link
url => fullLink original link
url => title website title

Errors

401 UnauthorizedYour API key is incorrect and a json with parameter auth:false has been returned
Subscription has expired or you've reached your shortening limitYou should consider upgrading your subscription plan

Link editing

Editing short links | from Single plan

In order to edit short link, open the file https://cutt.ly/api/api.php remotely (eg via the php file_get_contents), with the following parameters

key Your API key. Required
edit edit=[SHORT_LINK]
Your shortened link to be edited.
Required
userDomain If set to 1, then it will use account's user domain. Check subscription plans for more details - available from Single plan.
tag tag=[TAG]
The TAG you want to add for shortened link.
Optional
delete delete=1
It will delete your shortened link.
Optional
source source=[FULL LINK]
It will change the source url of shortened link. You can change source URL depending at your subscription plan.
[FULL LINK] should be passed through urlencode();
Optional
unique Sets a unique stat count for a short link.
unique=0 | It removes counting unique clicks.
unique=1 | for Single subscription plan. The time of uniqueness is 15 minutes.
unique=15-1440 | for Team subscription plans. Time to count unique clicks ranging from 15 minutes to 1440 minutes (24h).
Optional

Status for editing short links

status => 1OK
status => 2Could not save in database
status => 3The url does not exist or you do not own it
status => 4 (for source parameter only)URL didn't pass the validation

Errors

Insufficient subscription levelWhen using parameters without the required subscription.
Unique time must be between 15 - 1440 minutesTime to count unique clicks must be from 15 minutes to 1440 minutes (24h).

Link analytics

Analytics

In order to access URL statistics, open the file https://cutt.ly/api/api.php remotely (eg via the php file_get_contents), with the following parameters

key Your API key. Required
stats The shortened URL you want to check statistics of. Required
date_from It returns the number of clicks from a given period, both total and for social media. The correct format of the given dates: YYYY-MM-DD, e.g. 2021-03-02
Can be used with the second parameter date_to or separately
Available from Team subscription plan.
Optional
date_to It returns the number of clicks from a given period, both total and for social media. The correct format of the given dates: YYYY-MM-DD, e.g. 2021-03-02
Can be used with the second parameter date_from or separately
Available from Team subscription plan.
Optional

Examples

If status is equal to 1

In order to access URL statistics, open the file https://cutt.ly/api/api.php remotely (eg via the php file_get_contents), with the following parameters

stats=>dateDate of shortening the link
stats=>clicksTotal number of clicks
stats=>titleTitle of the shortened link
stats=>fullLinkOriginal link
stats=>shortLinkShortened link
stats=>facebookThe number of clicks from Facebook
stats=>twitterThe number of clicks from twitter
stats=>linkedinThe number of clicks from linkedin
stats=>restOther clicks

In order to display subsequent data, it should take place in a loop. (E.g. for, while, foreach loop)

Let $i to be the next variable in the array.

stats=>refs=>ref=>$i=>link displaying the domain from which you clicked on the link
stats=>refs=>ref=>$i=>clicks displaying the number of clicks from that domain
stats=>devices=>geo=>$i=>tag displaying the abbreviation of the country from which the link was clicked
stats=>devices=>geo=>$i=>clicks displaying the number of clicks from this country
stats=>devices=>dev=>$i=>tag displaying the type of device from which the link was clicked
stats=>devices=>dev=>$i=>clicks displaying the number of clicks from this device
stats=>devices=>sys=>$i=>tag displaying the operating system of the device from which the link was clicked
stats=>devices=>sys=>$i=>clicks displaying the number of clicks from this system
stats=>devices=>bro=>$i=>tag displaying the browser from which the link was clicked
stats=>devices=>bro=>$i=>clicks displaying the number of clicks from this browser

Errors

Incorrect date formatIn case the date format is incorrect. The correct format of the given dates: YYYY-MM-DD, e.g. 2021-03-02
Insufficient subscription levelWhen using parameters without the required Team subscription.