Retweet Rank: API

API Documentation

Retweetrank exposes its data via APIs. They are designed to provide data in a form that can easily be integrated into your application, site or widget.

Getting Started

To start, get an appid now by registering here.

Methods

Retweet Rank
Recent Retweets
Leaderboard
Top Tweets

Retweet Rank

URL:

http://api.retweetrank.com/rank/user.xml

Parameters:

appid (Required): <your app id>. Grab one here.
user (Required): username you want to query
Example Request: http://api.retweetrank.com/rank/TechCrunch.xml?appid=<your appid>

Sample XML Response:


<?xml version="1.0" encoding="UTF-8"?>
<retweetrank>
  <screen_name><![CDATA[TechCrunch]]></screen_name>
  <rank>1138534</rank>
  <percentile>-0.0</percentile>
  <url>http://www.techcrunch.com</url>
  <image>http://a3.twimg.com/profile_images/115466107/techcrunch_bigger_normal.png</image>
  <name><![CDATA[TechCrunch]]></name> <location><![CDATA[Silicon Valley]]></location>
  <description><![CDATA[Breaking Technology News And Opinions From TechCrunch]]></description>
</retweetrank>

Recent Retweets

URL:

http://api.retweetrank.com/retweets/user.xml

Parameters:

appid (Required): <your app id>. Grab one here.
page (Optional): The page number (starting at 1) to return, up to a max of roughly 50 pages

Sample XML Response:

<?xml version="1.0" encoding="UTF-8"?>
<retweetrank>
  <screen_name><![CDATA[ev]]></screen_name>
  <url>http://evhead.com</url>
  <image>http://a3.twimg.com/profile_images/519349177/ev-sky_normal.jpg</image>
  <name><![CDATA[Evan Williams]]></name>
  <location><![CDATA[San Francisco, CA, US]]></location>
  <description><![CDATA[CEO of Twitter]]></description>
  <page>1</page>
  <retweets>
    <retweet>
      <title><![CDATA[RT @captic: When @Biz @Ev & @Jack created Twitter, I don’t think they had any idea we would be using it the way we are today http://bit.ly/-9M]]></title>
      <link>http://twitter.com/patylouzada/statuses/8818582322</link>
      <pubdate>Mon, 08 Feb 2010 18:05:57 +0000</pubdate>
      <description><![CDATA[<b>RT</b> <a rel='nofollow' href="http://www.retweetrank.com/captic">@captic</a>: When <a rel='nofollow' href="http://www.retweetrank.com/Biz">@Biz</a> <a rel='nofollow' href="http://www.retweetrank.com/Ev"><b>@Ev</b></a> &amp; <a rel='nofollow' href="http://www.retweetrank.com/Jack">@Jack</a> created Twitter, I don’t think they had any idea we would be using it the way we are today <a rel='nofollow' href="http://bit.ly/-9M">http://bit.ly/-9M</a>]]></description>
      <image_link>http://a1.twimg.com/profile_images/658327524/of_normal.jpg</image_link>
      <author><![CDATA[patylouzada]]></author>
    </retweet>
    <retweet>
      <title><![CDATA[RT @Scobleizer: Other economic heros? @ev has created more than 100 jobs in three years. @markpinc has created 700... http://bit.ly/dhELh9]]></title>
      <link>http://twitter.com/jstan/statuses/8818310060</link>
      <pubdate>Mon, 08 Feb 2010 17:58:07 +0000</pubdate>
      <description><![CDATA[<b>RT</b> <a rel='nofollow' href="http://www.retweetrank.com/Scobleizer">@Scobleizer</a>: Other economic heros? <a rel='nofollow' href="http://www.retweetrank.com/ev"><b>@ev</b></a> has created more than 100 jobs in three years. <a rel='nofollow' href="http://www.retweetrank.com/markpinc">@markpinc</a> has created 700... <a rel='nofollow' href="http://bit.ly/dhELh9">http://bit.ly/dhELh9</a>]]></description>
      <image_link>http://a3.twimg.com/profile_images/637691743/twitterProfilePhoto_normal.jpg</image_link>
      <author><![CDATA[jstan]]></author>
    </retweet>
    ...
    <retweet>
      <title><![CDATA[RT @hardings930: RT @EveHallowsBook RT @hardings930: RT @EveHallowsBook RT @hardings930: RT @EveHallowsBook RT @hardings930: RT @Ev...  http://bit.ly/2dkvfl]]></title>
      <link>http://twitter.com/EveHallowsBook/statuses/8806662320</link>
      <pubdate>Mon, 08 Feb 2010 12:14:22 +0000</pubdate>
      <description><![CDATA[<b>RT</b> <a rel='nofollow' href="http://www.retweetrank.com/hardings930">@hardings930</a>: <b>RT</b> <a rel='nofollow' href="http://www.retweetrank.com/EveHallowsBook">@EveHallowsBook</a> <b>RT</b> <a rel='nofollow' href="http://www.retweetrank.com/hardings930">@hardings930</a>: <b>RT</b> <a rel='nofollow' href="http://www.retweetrank.com/EveHallowsBook">@EveHallowsBook</a> <b>RT</b> <a rel='nofollow' href="http://www.retweetrank.com/hardings930">@hardings930</a>: <b>RT</b> <a rel='nofollow' href="http://www.retweetrank.com/EveHallowsBook">@EveHallowsBook</a> <b>RT</b> <a rel='nofollow' href="http://www.retweetrank.com/hardings930">@hardings930</a>: <b>RT</b> <a rel='nofollow' href="http://www.retweetrank.com/Ev"><b>@Ev</b></a>...  <a rel='nofollow' href="http://bit.ly/2dkvfl">http://bit.ly/2dkvfl</a>]]></description>
      <image_link>http://a3.twimg.com/profile_images/616858335/3_normal.jpg</image_link>
      <author><![CDATA[EveHallowsBook]]></author>
    </retweet>
 </retweets>  
</retweetrank>

Leaderboard

The top ranked twitter users, who have been most retweeted recently, are returned by this API

URL:

http://api.retweetrank.com/leaderboard/top.xml

Parameters:

appid (Required): <your app id>. Grab one here.
count (Optional): Number of top users. Minimum 1 and maximum 50 (want more? Contact us)

Sample XML Response:

<?xml version="1.0" encoding="UTF-8"?>
<leaderboard>
    <user>
      <screen_name><![CDATA[RevRunWisdom]]></screen_name>
      <rank>1</rank>
      <image_url>http://a1.twimg.com/profile_images/116514496/revrunfortwitter2_normal.jpg</image_url>
      <name><![CDATA[Rev Run]]></name>
    </user>
    <user>
      <screen_name><![CDATA[tweetmeme]]></screen_name>
      <rank>2</rank>
      <image_url>http://a1.twimg.com/profile_images/385906476/icon_main_normal.png</image_url>
      <name><![CDATA[TweetMeme]]></name>
    </user>
</leaderboard>

Top Tweets

Returns recent top tweets for the given user.

URL:

http://api.retweetrank.com/toptweets/user.xml

Parameters:

appid (Required): <your app id>. Grab one here.

Sample XML Response:


<?xml version="1.0" encoding="UTF-8"?>
<retweetrank>
  <screen_name><![CDATA[ev]]></screen_name>
  <url><![CDATA[http://t.co/C2HZiQ4]]></url>
  <image>http://a1.twimg.com/profile_images/1275356729/evedit0xr_2__1__normal.jpg</image>
  <name><![CDATA[Evan Williams]]></name>
  <location><![CDATA[San Francisco, CA, US]]></location>
  <description><![CDATA[Farm boy from Nebraska. Husband and father. Co-founder of Twitter. Partner at @ObviousCorp]]></description>
  <tweets>
    <tweet>
      <title><![CDATA[Placebo Buttons! "...the close buttons don’t close the elevator doors in most elevators" http://t.co/x8SzODp8]]></title>
      <link>http://twitter.com/ev/status/139159265783984129</link>
      <pubdate></pubdate>
      <description><![CDATA[Placebo Buttons! "...the close buttons don’t close the elevator doors in most elevators" http://t.co/x8SzODp8]]></description>
      <image_link>http://a1.twimg.com/profile_images/1275356729/evedit0xr_2__1__normal.jpg</image_link>
      <author><![CDATA[ev]]></author>
      <retweet_count>85</retweet_count>
    </tweet>
    <tweet>
      <title><![CDATA[Must be a tough spot when you run an ad campaign to stress the opposite of what your brand is known for. http://t.co/YLQDl7Zo]]></title>
      <link>http://twitter.com/ev/status/138660700175339520</link>
      <pubdate></pubdate>
      <description><![CDATA[Must be a tough spot when you run an ad campaign to stress the opposite of what your brand is known for. http://t.co/YLQDl7Zo]]></description>
      <image_link>http://a1.twimg.com/profile_images/1275356729/evedit0xr_2__1__normal.jpg</image_link>
      <author><![CDATA[ev]]></author>
      <retweet_count>74</retweet_count>
    </tweet>
  </tweets>  
</retweetrank>

Terms

By using the Retweet Rank API you are agreeing to adhere to our terms of service:

You must attribute the data you fetch from the API to Retweet Rank
Usage Limits: 1,000 calls per day. Need more? Email us at support@retweetrank.com
Any displayed profile data needs to include a backlink to the user's profile on Retweet Rank i.e. http://www.retweetrank.com/<username>
If you want to use the API commercially, contact us at support@retweetrank.com to discuss details
You may not pass this data onto third parties. Expressly, you may not give or sell the data retrieved via the API
Don't use the data to compete with Retweet Rank. Contact us if you want to discuss deep integration
There are no implied or expressed warranties, guarantees, SLAs for the API.

Support

Mail us at support@retweetrank.com

Ready to start?

Get an appid now by registering here.