Cuttly | Free Custom URL Shortener, Branded URLs, Link Management, API

Team API
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 with team, open the file https://cutt.ly/team/API/index.php remotely (eg via the php file_get_contents), and in the parameters: key enter your team API key, action specify your action, either shorten to shorten a link or stats to get link analytics. url 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, domain specify if you want to use your own domain, to choose your team domain to be used, enter its name.

Possible parameters

`key`	Your API key. Required
`action`	Your action to perform, either shorten or stats. Required
`url`	Either your long link to be shortened or your short link to get analytics. Required
`name`	Your desired short link if not already taken
`domain`	Your desired domain to be used (only with action shorten)

Examples

PHP C# Java Python

                    
$url = urlencode('[URL_YOU_WANT_SHORTEN]');
$json = file_get_contents('https://cutt.ly/team/API/index.php?key=[API_KEY]&action=[shorten]&url=$url&name=[CUSTOM_URL_ALIAS]&domain=[domain name (cutt.ly)]');
$data = json_decode ($json, true);
var_dump($data);

                    
public class Class1
    {
        private const string URL = "https://cutt.ly/team/API/index.php";
        private string urlParameters = "?key=[API_KEY]&action=[shorten]&url=[URL_YOU_WANT_SHORTEN]&name=[CUSTOM_URL_ALIAS]&domain[domain name (cutt.ly)]";

        static void Main(string[] args)
        {
            HttpClient client = new HttpClient();
            client.BaseAddress = new Uri(URL);

            // Add an Accept header for JSON format.
            client.DefaultRequestHeaders.Accept.Add(
            new MediaTypeWithQualityHeaderValue("application/json"));

            // List data response.
            HttpResponseMessage response = client.GetAsync(urlParameters).Result;  // Blocking call! Program will wait here until a response is received or a timeout occurs.
            if (response.IsSuccessStatusCode)
            {
                // Parse the response body.
                var dataObjects = response.Content.ReadAsAsync>().Result;  //Make sure to add a reference to System.Net.Http.Formatting.dll
                foreach (var d in dataObjects)
                {
                    Console.WriteLine("{0}", d.Name);
                }
            }
            else
            {
                Console.WriteLine("{0} ({1})", (int)response.StatusCode, response.ReasonPhrase);
            }

            //Make any other calls using HttpClient here.

            //Dispose once all HttpClient calls are complete. This is not necessary if the containing object will be disposed of; for example in this case the HttpClient instance will be disposed automatically when the application terminates so the following call is superfluous.
            client.Dispose();
        }
    }

                    
import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.MalformedURLException;
import java.net.URL;

public class NetClientGet {

	public static void main(String[] args) {

	  try {

		URL url = new URL("https://cutt.ly/team/API/index.php?key=[API_KEY]&action=[shorten]&url=[URL_YOU_WANT_SHORTEN]&name=[CUSTOM_URL_ALIAS]&domain=[domain name (cutt.ly)]");
		HttpURLConnection conn = (HttpURLConnection) url.openConnection();
		conn.setRequestMethod("GET");
		conn.setRequestProperty("Accept", "application/json");

		if (conn.getResponseCode() != 200) {
			throw new RuntimeException("Failed : HTTP error code : "
					+ conn.getResponseCode());
		}

		BufferedReader br = new BufferedReader(new InputStreamReader(
			(conn.getInputStream())));

		String output;
		System.out.println("Output from Server .... \n");
		while ((output = br.readLine()) != null) {
			System.out.println(output);
		}

		conn.disconnect();

	  } catch (MalformedURLException e) {

		e.printStackTrace();

	  } catch (IOException e) {

		e.printStackTrace();

	  }

	}

}

                    
import urllib
import requests
key = '[API_KEY]'
action = 'shorten'
url = urllib.parse.quote('[URL_YOU_WANT_SHORTEN]')
name  = '[CUSTOM_URL_ALIAS]'
domain = '[domain name (YOUR_TEAM_CUSTOM_DOMAIN.com)]'
r = requests.get('https://cutt.ly/team/API/index.php?key={}&action={}&url={}&name={}&domain={}'.format(key, action, url, name, domain))
print(r.text)

Errors

`401 Unauthorized`	Your API key is incorrect and a json with parameter auth:false has been returned
`401 Subscription has expired`	Team owner's subscription has expired
`400 Incorrect action`	Action is null or incorrect
`400 Url parameter is null`	Parameter url was not sent
`409 Provided link is already shortened`	Provided link's domain is a registered cutt.ly domain
`409 Provided link is incorrect`	Provided url is not a link
`409 Provided alias contains illegal characters`	Name parameter contains illegal characters

Analytics

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

`key`	Your Team API key. Required
`action`	The shortened URL you want to check statistics of. Required
`url`	The shortened URL you want to check statistics of. E.g. https://cutt.ly/short or https://yourdomain.com/short. Required

Examples

PHP C# Java Python

                    
$json = file_get_contents('https://cutt.ly/team/API/index.php?key=[API_KEY]action=stats&&url=[SHORTENED_URL]');
$data = json_decode ($json, true);
var_dump($data);

                    
public class Class1
    {
        private const string URL = "https://cutt.ly/team/API/index.php";
        private string urlParameters = "?key=[API_KEY]action=stats&&url=[SHORTENED_URL]";

        static void Main(string[] args)
        {
            HttpClient client = new HttpClient();
            client.BaseAddress = new Uri(URL);

            // Add an Accept header for JSON format.
            client.DefaultRequestHeaders.Accept.Add(
            new MediaTypeWithQualityHeaderValue("application/json"));

            // List data response.
            HttpResponseMessage response = client.GetAsync(urlParameters).Result;  // Blocking call! Program will wait here until a response is received or a timeout occurs.
            if (response.IsSuccessStatusCode)
            {
                // Parse the response body.
                var dataObjects = response.Content.ReadAsAsync>().Result;  //Make sure to add a reference to System.Net.Http.Formatting.dll
                foreach (var d in dataObjects)
                {
                    Console.WriteLine("{0}", d.Name);
                }
            }
            else
            {
                Console.WriteLine("{0} ({1})", (int)response.StatusCode, response.ReasonPhrase);
            }

            //Make any other calls using HttpClient here.

            //Dispose once all HttpClient calls are complete. This is not necessary if the containing object will be disposed of; for example in this case the HttpClient instance will be disposed automatically when the application terminates so the following call is superfluous.
            client.Dispose();
        }
    }

                    
import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.MalformedURLException;
import java.net.URL;

public class NetClientGet {

	public static void main(String[] args) {

	  try {

		URL url = new URL("https://cutt.ly/team/API/index.php?key=[API_KEY]&action=stats&url=[SHORTENED_URL]");
		HttpURLConnection conn = (HttpURLConnection) url.openConnection();
		conn.setRequestMethod("GET");
		conn.setRequestProperty("Accept", "application/json");

		if (conn.getResponseCode() != 200) {
			throw new RuntimeException("Failed : HTTP error code : "
					+ conn.getResponseCode());
		}

		BufferedReader br = new BufferedReader(new InputStreamReader(
			(conn.getInputStream())));

		String output;
		System.out.println("Output from Server .... \n");
		while ((output = br.readLine()) != null) {
			System.out.println(output);
		}

		conn.disconnect();

	  } catch (MalformedURLException e) {

		e.printStackTrace();

	  } catch (IOException e) {

		e.printStackTrace();

	  }

	}

}

                    
import urllib
import requests
key = '[API_KEY]'
action = 'stats'
url = urllib.parse.quote('[SHORTENED_URL]')
r = requests.get('https://cutt.ly/team/API/index.php?key={}&action={}&url={}'.format(key, action, url))
print(r.text)

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

`stats=>status: 0`	This shortened link does not exist
`stats=>status: 1`	This link exists and the data has been downloaded
`stats=>status: 2`	Invalid API key

If status is equal to 1

`stats=>date`	Date of shortening the link
`stats=>clicks`	Total number of clicks
`stats=>title`	Title of the shortened link
`stats=>fullLink`	Original link
`stats=>shortLink`	Shortened link
`stats=>facebook`	The number of clicks from Facebook
`stats=>twitter`	The number of clicks from twitter
`stats=>linkedin`	The number of clicks from linkedin
`stats=>rest`	Other 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

Team API API Documentation.

URL Shortener

Possible parameters

Examples

Errors

Analytics

Examples

If status is equal to 1

Team API
API Documentation.