About Instructions Bookmarklet API Terms

The Tharp Me! URL Shortener API Definition

The tharp.me API is very simple to use. Simply pass the urlencoded URL you wish to shorten via HTTP GET or HTTP POST to http://tharp.me/ in a variable named "url", and the only text we will return is the shortened URL.

In the event of an error, we will return the text "ERROR:" directly followed by an explanation (no newlines).

Example: http://tharp.me/?url=http%3a%2f%2fjeremytharp.com%2f

This is a simple, browser-based GET sample. The same result can, of course, be achieved using cURL or another server-side HTTP connection interface.

Note: It is not required to urlencode the URL, but we always perform the PHP urldecode() on all URL's submitted, so to avoid potential ambiguities, it is best to do so.