Twitter Counter tracks statistics of more than 10 million Twitter users

Twitter Counter API

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/

Request parameters

The following parameters are required:

twitter_id

: the user's twitter id.

A user's twitter id is NOT his username, but a number! The following won't work:

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)

Response parameters

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

Example usage

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.

Rate limiting

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.

HTTP Status Codes

The following status codes are returned by the Twitter Counter API:

200 OK: everything was ok, data was returned 401 Unauthorized: API credentials are missing or incorrect 403 Forbidden: API limit has been reached 404 Not Found: the given Twitter id could not be found on Twitter Counter 500 Internal Server Error: could not properly load the necessary elements from Twitter Counter 503 Service Not Available: Twitter Counter is down or unavailable