Login to My Dot TK
Dot TK



header

Technical

How does TweaK work?

When you shorten a URL, Dot TK stores the long version in its database and assigns the URL a new domain name that ends with the .TK extension. For example, if you shorten the URL http://www.google.com and the link you get back is http://bcdef.tk, then the unique domain name that your URL has been assigned is bcdef.tk.

The domain name is instantly made in our Top Level Domain DNS. That means that immediately after registration you are able to use www.bcdef.tk.

When somebody visits your new short domain name, Dot TK takes the domain and redirects the user to the original long URL that is stored in our database. If you sign up for a Dot TK account you can track all the traffic to your domains.

TweaK API

Dot TK's TweaK API service lets developers design computer programs and online applications that interact directly with the Dot TK registration system for free domain name registration services.

This basically means that Dot TK allows developers to register short URL's and free domain names with the .TK extension, in the background of their applications.

The TweaK API offers two functions;
shorten – for shortening a random URL and
lengthen – for resolving the short name.

Shorten

To shorten any long address, simply POST or GET the address to our API and parse the answer.
http://api.dot.tk/tweak/shorten?long=

Request
The specified longaddress needs to be an URL encoded representation of the URL. If the URL http://www.dot.tk needs to be shortened, it should be passed as http%3A%2F%2Fwww.dot.tk. The 'http://' part of the passed long URL may be omitted.

Response
The response's header will indicate if the shortening was successful or not. A HTTP response code 200 indicates the shorting was a success.

In case of success, the responses body will contain two lines:
http://bcdef.tk
http://tk./bcdef

The first line will return the created domain name. The second line will display the shortened URL. They both work instantly. The next line is indicated with a carriage return. The domain name is immediately available to use everywhere in the world. Please note that the shortened URL sometimes is not correctly interpreted as an hyperlink in some applications. However, the shortened URL is a real working URL and works in all browsers.

When an error occurred, the HTTP response code will be set to one of the following:

400: Long URL not submitted
401: Long URL is invalid
402: Quota reached
403: Shortname already taken
409: An other error happened

On error, the content body will be empty. Per IP address only 250 addresses maybe shortened per 24 hours. When this maximum is reached, error 402 will be returned. This maximum can be increased or released when the Dot TK staff are informed about the application that is using the API.

Lengthen

To resolve any short address, please post the short address to::
http://api.dot.tk/tweak/lengthen?shortname=

Request
The short address may be one of the following:
- The short address, ie: http://tk./bcdef
- The domain, ie: http://bcdef.tk
- The shortname, ie: bcdef

Response
In case of success, HTTP response code 200 will be returned. The body's content will contain the original long address, i.e: http://maps.google.com/maps?f=q&source=s_q&hl=en&geocode=&q=tokelau&sll=37.0625,-95.677068&sspn=45.736609,73.125&ie=UTF8&ll=-9.236315,-171.867371&spn=0.895969,1.142578&z=10

When an error occurred, the HTTP response code will be set to one of the following:
410: Short URL not submitted
411: Short URL invalid syntax
412: Short URL not found

On error, the content body will be empty.

Forum

If you have any problems with getting the TweaK API to work please refer to the online API Forum at www.apiforum.tk.

Dot TK and abuse and copyright infringement:

If you want to report abuse of a shortened URL or domain name, please send a detailed email with your complaint to abusedot.tk. In most cases Dot TK responds to abuse complaints within one business day.

If you want to report a case of copyright infringement, please send an email to copyrightdot.tk, and include the full name and address of your organization. Within 5 business days copyright infringement notices will be investigated.

How long do the new shortened TweaK domains last?

We never remove shortened URLs, as long as they are created in accordance with our terms & conditions.