The Twitter Counter API allows you to retrieve everything Twitter Counter knows about a certain Twitter username. It uses a simple REST API, which can be called on at the following URL:
http://api.twittercounter.com/
The following parameters are required:
twitter_id: the user's twitter id.
twitter_id=my_username. Use this instead:
twitter_id=1234567. See examples for more details.
apikey: the API key for Twitter Counter
The following parameters are optional:
output: can either be JSON or JSONP, default is JSON
callback: if JSON is selected as output, callback needs to be set to the Javascript method that you would like called
count: the number of days for which you would like stats returned (if available). Default (and for now maximum) is 14 days (two weeks)
The Twitter Counter API returns results in either JSON or JSONP (see request parameters). The following parameters are returned by the Twitter Counter API:
version: the current API version
username: Twitter username of the requested user
url: URL of the request user
avatar: avatar URL of the requested user
followers_current: current followers count of the requested user
date_updated: the latest statistics update for the requested user
follow_days: the number of days Twitter Counter has been tracking the requested user
started_followers: the number of followers when we started tracking the requested user
growth_since: the number of followers gained since we started tracking the requested user
average_growth: the average growth per day of the requested user
tomorrow: our followers prediction for tomorrow for the requested user
next_month: our followers prediction for the next month for the requested user
followers_yesterday: the number of followers for the previous day for the requested user
rank: the requested user's rank as calculated by Twitter Counter
followersperdate: a list of dates and the followers count on that date. The list is formatted like this: date{yyyy-mm-dd} : {followers_count}
last_update: a UNIX timestamp of when this record was last updated
http://api.twittercounter.com/?apikey=e9335031a759f251ee9b4e2e6634e1c5&twitter_id=15160529
http://api.twittercounter.com/?apikey=e9335031a759f251ee9b4e2e6634e1c5&twitter_id=15160529&output=jsonp&callback=myCallbackMethod
The following will NOT work (note the username instead of the twitter id):
http://api.twittercounter.com/?apikey=e9335031a759f251ee9b4e2e6634e1c5&twitter_id=TheCounter
Note that all requests must be GET requests.
By default rate limiting is set to 100 calls per hour per user. If you need more than 100 calls per hour per user send us an email explaining how many calls you need and why you need that amount of calls.
The following status codes are returned by the Twitter Counter API:
