API Documentation
The API is available only to registered users
API key can be generate in account edit page
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, name specify the preferred shortening of the link.
example:
$json = file_get_contents(https://cutt.ly/api/api.php?key=[API_KEY]&short=[URL_YOU_WANT_SHORTEN]&name=[CUSTOM_URL_ALIAS]);
As a reply, string json will be sent. It should then be decoded using the php function $data = json_decode ($json, true)
In this way, an array with information about the shortened link will be returned: $data["url"]
$data["url"]["status"] in the case of shortening can return 5 values:
1: the shortened link comes from the domain that shortens the link, i.e. the link has already been shortened.2: the entered link is not a link.
3: the preferred link name is already taken
4: Invalid API key
5: the link has not passed the validation. Includes invalid characters
6: The link provided is from a blocked domain
7: OK - the link has been shortened
If the status is equal to 7, then:
$data["url"]["date"] - date of shortening the link
$data["url"]["shortLink"] - shortened link
$data["url"]["fullLink"] - original link
$data["url"]["title"] - website title
Analytics
In the case of access to statistics, open the file https://cutt.ly/api/api.php remotely with the following parameter:
$json = file_get_contents(https://cutt.ly/api/api.php?key=[API_KEY]&stats=[SHORTENED_URL]);
As a reply, string json will be sent.
It should then be decoded using the php function $data = json_decode($json, true)
In this way, an array with information about the shortened url will be returned: $data["stats"]
In this case, $data["stats"]["status"] can return three values:
0: This shortened link does not exist
1: This link exists and the data has been downloaded
2: Invalid API key
If the status is 1, then:
$data["stats"]["date"] - date of shortening the link
$data["stats"]["clicks"] - total number of clicks
$data["stats"]["title"] - title of the shortened link
$data["stats"]["fullLink"] - original link
$data["stats"]["shortLink"] - shortened link
$data["stats"]["facebook"] - the number of clicks from facebook
$data["stats"]["twitter"] - the number of clicks from twitter
$data["stats"]["pinterest"] - the number of clicks from pinterest
$data["stats"]["googlePlus"] - the number of clicks from google plus
$data["stats"]["linkedin"] - the number of clicks from linkedin
$data["stats"]["rest"] - other clicks
The display of subsequent data should take place in the loop, because the amount of data is not constant.
Let $i to be the next variable in the array.
$data["stats"]["refs"]["ref"][$i]["link"] - displaying the domain from which you clicked on the link
$data["stats"]["refs"]["ref"][$i]["clicks"] - displaying the number of clicks from that domain
$data["stats"]["devices"]["geo"][$i]["tag"] - displaying the abbreviation of the country from which the link was clicked
$data["stats"]["devices"]["geo"][$i]["clicks"] - displaying the number of clicks from this country
$data["stats"]["devices"]["dev"][$i]["tag"] - displaying the type of device from which the link was clicked
$data["stats"]["devices"]["dev"][$i]["clicks"] - displaying the number of clicks from this device
$data["stats"]["devices"]["sys"][$i]["tag"] - displaying the operating system of the device from which the link was clicked
$data["stats"]["devices"]["sys"][$i]["clicks"] - displaying the number of clicks from this system
$data["stats"]["devices"]["bro"][$i]["tag"] - displaying the browser from which the link was clicked
$data["stats"]["devices"]["bro"][$i]["clicks"] - displaying the number of clicks from this browser
See offers:
Try Faster Web Hosting
