| More

The TunkRank API

The TunkRank API is a RESTful API accessible via HTTP. There are two main operations right now: fetching a score for a user and issuing a refresh request for a user. These may be accessed as follows (where ident is the screen name or twitter id and format is xml or json):


         http://tunkrank.com/score/{ident}.{format}
   http://tunkrank.com/refresh/{ident}.{format}

To play around with the API, we recommend using curl. For example,


         curl http://tunkrank.com/score/tunkrank.xml

would return:


      <?xml version="1.0" encoding="UTF-8"?>
   <twitter-user>
      <num-followers type="integer">160</num-followers>
      <num-friends type="integer">181</num-friends>
      <screen-name>tunkrank</screen-name>
      <tunkrank-computed-at type="datetime">2010-02-16T05:10:20Z</tunkrank-computed-at>
      <twitter-id type="integer">19138053</twitter-id>
      <raw-tunkrank-score type="float">2.84</raw-tunkrank-score>
      <ranking type="integer">11</ranking>
   </twitter-user>

The TunkRank API limits the number of anonymous requests per day to 500. If you would like to be whitelisted, please fill out this form.