TwitterCounter API

The TwitterCounter API allows you to retrieve everything TwitterCounter knows about a certain Twitter username. It uses a simple REST API, which can be called on at the following URL:

http://twittercounter.com/api/

Parameters

It takes the following parameters:

username (obligatory)	The Twitter username of the person you want the details for.
output (optional)	Defines which type of output you get, options are:
	xml	for XML results (default)
	json	for JSON results
	php	for serialized PHP
results (optional)	Determines how far back you want to go, defaults to 14 days.

Examples

This call:

http://twittercounter.com/api/?username=jdevalk&output=xml&results=3

At 11-22-2008 this would have given the following result:

<twittercounter>	
	<user_id>683</user_id> 
	<user_name>jdevalk</user_name> 
	<followers_current>1983</followers_current> 
	<date_updated>2008-11-22 23:59:59</date_updated> 
	<url></url> 
	<avatar>58280789/joost-avatar_normal.jpg</avatar> 
	<follow_since>2008-06-13</follow_since> 
	<started_followers>1078</started_followers> 
	<growth_since>905</growth_since> 
	<average_growth>5.9150326797386</average_growth> 
	<tomorrow>1989</tomorrow> 
	<next_month>2160</next_month> 
	<followers_yesterday>1977</followers_yesterday> 
	<followers_2w_ago>1970</followers_2w_ago> 
	<growth_since_2w>13</growth_since_2w> 
	<average_growth_2w>1</average_growth_2w> 
	<tomorrow_2w>1984</tomorrow_2w> 
	<next_month_2w>2013</next_month_2w> 
	<followersperdate> 
		<date2008-11-20>1970</date2008-11-20> 
		<date2008-11-21>1977</date2008-11-21> 
		<date2008-11-22>1983</date2008-11-22> 
	</followersperdate> 
</twittercounter>

Feel free to use our API but do please let us know what you did with it and where you use it. We love to see what people do with our data and link to you here:

Example use

Services that use the TwitterCounter API

Clicky - Web Analytics
Clicky Web Analytics is simply the best way to monitor, analyze, and react to your blog or web site's traffic in real time. Clicky uses the TwitterCounter API to show your Twitter stats right inside of Clicky
http://getclicky.com/

Mint Pepper
Joost de Valk developed the API for TwitterCounter and a Mint Pepper so you can see your Twitter Follower stats in Mint.
http://yoast.com/twittercounter-api/

TweetDeck
TweetDeck is an Adobe Air desktop application that is currently in public beta. On start-up TweetDeck queries the API and shows a short summary of your stats.
http://www.tweetdeck.com/beta/

Mac OS X TwitterCounter Dashboard
Developed by Joost de Valk (also see Min Pepper) this dashboard uses the API to show you your stats right in the Mac OS X Dashboard.
http://yoast.com/twittercounter-dashboard-widget/

TwtrCtr
TwitterCounter user @andypiper developed this iPhone optimized TwitterCounter interface. Add a bookmark on the iPhone home screen to TwtrCtr and check your daily TwitterCounter stats from there.
http://andypiper.tv/twtrctr/

Slandr.net Mobile Twitter
Utilizes the Twitter API to the fullest to bring you a complete Twitter service for your mobile browser. Featuring DM, replies, ego-view, search, following, deleting, favouriting, TwitterCounter, Last.fm local event search, inline viewing of picture-links from MobyPicture, TwitPic and Autopostr, TwitterLocal integration. And uploading pictures to MobyPicture and TwitPic. All-in-all 11 different APIs" :-)
http://m.slandr.net

TwitWall
When its too long to tweet, but too short to blog, just TwitWall it! TwitWall is the easy-to-use, quick-to-blast-out blog companion for Twitter. With TwitWall, you can embed your favorite videos and widgets, upload your photos, mp3 music or podcasts, - you name it. Every TwitWall shows a TwitterCounter on every TwitWall.
http://twitwall.com

@Whoot
whoot is a live Twitter interface to the http://twittercounter.com API. SImply tweet "@whoot me" and you will instantly get back your stats via Twitter.
http://twitter.com/whoot

Floxee
Floxee is a new service from Squeejee that allows companies, people or organizations of any nature group and brand their Twitter presence. Floxee adds some great features to enhance the user experience such as a searchable tweetstream, community talkback channel, directory stats, custom layouts and more. Floxee is the engine that powers the award-winning website, TweetCongress.org.
http://floxee.com