Twlr.me API
Why do I use Twlr.me ?
I can get comprehensive stats on how my links are used :
- clicks
- referrers
- locations
- who RTs (soon)
- how many RTs (soon)
- estimate crowd hit (soon)
Use is hassle-free with the bookmarklet : Twlr.me (drag it on your sidebar)
Techies? There's an API for you :)
Features
- Generate or get existing short URLs, with sequential or custom keyword
- Get click rate (and some informations) about a link
- Output format: JSON, XML, or simple raw text
Usage
You need to send parameters to http://twlr.me/api.php either via GET or POST. These parameters are:
- The requested
action: "shorturl" (get short URL for a link), "expand" (get long URL of a shorturl), "url-stats" (get stats about one short URL) or "stats" (get stats about your links) - With action = "shorturl" :
- the
urlto shorten - optional
keywordfor custom short URLs - output
format: either "json", "xml" or "simple"
- the
- With action = "expand" :
- the
shorturlto expand (can be either 'abc' or 'http://site/abc') - output
format: either "json", "xml" or "simple"
- the
- With action = "url-stats" :
- the
shorturlfor which to get stats (can be either 'abc' or 'http://site/abc') - output
format: either "json" or "xml"
- the
- With action = "stats" :
- the
filter: either "top", "bottom" , "rand" or "last" - the
limit(maximum number of links to return) - output
format: either "json" or "xml"
- the
Sample return
<result>
<url>
<id>62019439011</id>
<keyword>shorter</keyword>
<url>http://somereallylongurlyouneedtoshrink.com/</url>
<date>2009-06-23 18:08:07</date>
<ip>127.0.0.1</ip>
</url>
<status>success</status>
<message>http://somereallylongurlyouneedtoshrink.com/ (ID: shorter) added to database</message>
<shorturl>http://yoursite.com/shorter</shorturl>
</result>
Sample file
Here is a sample file in PHP
