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
Featured twitter user
HamzeiAnalytics RT @sentimentrader: Uh-oh. Commercial hedgers in the NDX at an extreme net short. http://twitpic.com/qa361 please RT
ricky_martin Back home! Long flightpeace u all!de vuelta a casa! Viaje largo!
george_revutsky You're in a bubble when over 40% at a tech event are unnaturally thin women. No bubble, but def. saw some froth at #crunchup
Become featured twitter user
Twitter Widget
Show your face on thousands of blogs by signing in:
Get your twitter widget
See who of your Twitter friends visit your site.