VB.ly API

Features

* Generate or get existing short URLs, with sequential or custom keyword
* Get some statistics about your links: top clicked links, least clicked
links, newest links * Output format: JSON, XML, or simple raw text

Usage

You need to send parameters to http://vb.ly/api/ either via GET or POST.
These parameters are:

* The requested action: either "shorturl" (get short URL for a link) or
"stats" (get stats about your links)

* With action = "shorturl" :
	o url - the url to shorten
	o keyword - optional keyword for custom short URLs
	o format - output format: either "json", "xml" or "simple"

	eg http://vb.ly/api/?action=shorturl&url=http://www.google.com&keyword=google&format=xml

* With action = "stats" :
	o filter - the filter: either "top", "bottom" or "last"
	o limit - the limit (maximum number of links to return)
	o format - output format: either "json" or "xml"

	** the stats API is only returning aggregated stats at this time **

Sample return for action = "shorturl"

<result>
	<url>
		<id>google</id>
		<keyword>shorter</keyword>
		<url>http://www.google.com/</url>
		<date>2009-06-23 18:08:07</date>
		<ip>127.0.0.1</ip>
	</url>
	<status>success</status>
	<message>http://www.google.com/ (ID: shorter) added to database</message>
	<shorturl>http://vb.ly/google</shorturl>
</result>

Please let us know if you are doing anything interesting with the API -
drop us a line at violet at tinynibbles dot com

Use of the VB.ly API, as with the rest of the VB.ly service, is provided
"as is" at your own risk with no warranties implied. We make no
guarantees as to the availability of the service at any time.