Short URL

API

With this API you can easily get the short URL and all statistics in JSON or XML format by sending the long URL to the API. You can also access just the statistics without the system to count it as a new URL shortening.

Please, let us know if you use this API. We would really like to see what kind of cool app, widget or page you create. Thanks!

Method

To interact with the API use an HTTP GET request.

URL Format

https://go.kenda.fi/api/?format=<format>&url=<url>

Parameters

Name	Description	Value	Required
format	Render the response in the specified format. Default: json	json xml	no
url	The long URL you want to shorten. This has to be URL encoded. In Javascript you can do that with encodeURIComponent() and in PHP with urlencode().	string	yes

HTTP response status codes

Status code	Description
200 OK	Great success!
400 Bad Request	The URL was not valid.
406 Not Acceptable	The URL is already quite short.
406 Not Acceptable	The URL seems to be blocked.
406 Not Acceptable	The URL or parts of it seems to be blacklisted.
502 Bad Gateway	Rate limit was exceeded.
503 Service Unavailable	Some other error or the short URL service is in maintenance mode.

Examples

https://go.kenda.fi/api/?format=json &url=www.codeigniter.com%2Fnews%2Fcodeigniter_2.0.0_released%2F

stdClass Object
(
    [status] => ok
    [message] => Great success!
    [short_url] => https://go.kenda.fi/3
    [long_url] => https://www.codeigniter.com/news/codeigniter_2.0.0_released/
    [percent_shorter] => 65
    [qrcode_img] => https://go.kenda.fi/3/qrcode/
    [qrcode_img_width] => 180
    [qrcode_img_height] => 180
    [link_accessed] => 21
    [link_added] => stdClass Object
        (
            [count] => 1
            [first_time] => 2011-01-29 11:19
            [last_time] => 
            [via_www] => 1
            [via_bookmarklet] => 0
            [via_api] => 0
            [via_other] => 0
        )

    [referrer_count] => 0
    [referrers] => Array
        (
        )

)

https://go.kenda.fi/api/?format=xml &url=www.codeigniter.com%2Fnews%2Fcodeigniter_2.0.0_released%2F

<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<go>
<status>ok</status>
<message><![CDATA[Great success!]]></message>
<id>3</id>
<short_url>https://go.kenda.fi/3</short_url>
<long_url><![CDATA[https://www.codeigniter.com/news/codeigniter_2.0.0_released/]]></long_url>
<title><![CDATA[CodeIgniter 2.0.0 Released | CodeIgniter - News]]></title>
<percent_shorter>65</percent_shorter>
<qrcode_img width="180" height="180">https://go.kenda.fi/3/qrcode/</qrcode_img>
<link_accessed>21</link_accessed>
<link_added count="1">
 <first_time>2011-01-29 11:19</first_time>
 <last_time></last_time>
 <via_www>1</via_www>
 <via_bookmarklet>0</via_bookmarklet>
 <via_api>0</via_api>
 <via_other>0</via_other>
</link_added>
<referrers count="0">
</referrers>
</go>

Possible errors:

stdClass Object
(
    [status] => error
    [message] => The URL was not valid.
)

stdClass Object
(
    [status] => error
    [message] => The URL is already quite short.
)

stdClass Object
(
    [status] => error
    [message] => The URL seems to be blocked.
)

stdClass Object
(
    [status] => error
    [message] => The URL or parts of it seems to be blacklisted.
)

stdClass Object
(
    [status] => error
    [message] => Rate limit was exceeded.
)

stdClass Object
(
    [status] => error
    [message] => Some other error or the short URL service is in maintenance mode.
)

<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<go>
<status>error</status>
<message><![CDATA[The URL was not valid.]]></message>
</go>

<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<go>
<status>error</status>
<message><![CDATA[The URL is already quite short.]]></message>
</go>

<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<go>
<status>error</status>
<message><![CDATA[The URL seems to be blocked.]]></message>
</go>

<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<go>
<status>error</status>
<message><![CDATA[The URL or parts of it seems to be blacklisted.]]></message>
</go>

<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<go>
<status>error</status>
<message><![CDATA[Rate limit was exceeded.]]></message>
</go>

<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<go>
<status>error</status>
<message><![CDATA[Some other error or the short URL service is in maintenance mode.]]></message>
</go>

Statistics API

Use this in case you want to get the same data including statistics as when creating a new short URL, but without the system to count it as a new URL shortening.