Twitter REST API Method: statuses retweets_of_me

Page history last edited by Marcel Molina 5 days ago

  << Back to Twitter API Documentation

 

 Twitter REST API Method: statuses/retweets_of_me

Returns the 20 most recent tweets of the authenticated user that have been retweeted by others.

method status | report a bug
 

URL:

http://api.twitter.com/1/statuses/retweets_of_me.format

 

Formats: 

xml, json, atom 

 

HTTP Method(s):

GET

 

Requires Authentication (about authentication):

true

 

API rate limited (about rate limiting):

1 call per request

 

Parameters:

  • since_id.  Optional.  Returns only statuses with an ID greater than (that is, more recent than) the specified ID. 
    • Example: http://api.twitter.com/1/statuses/retweets_of_me.xml?since_id=12345
  • max_id. Optional.  Returns only statuses with an ID less than (that is, older than) or equal to the specified ID.
    • Example: http://api.twitter.com/1/statuses/retweets_of_me.xml?max_id=54321
  • count.  Optional.  Specifies the number of statuses to retrieve. May not be greater than 200. 
    • Example: http://api.twitter.com/1/statuses/retweets_of_me.xml?count=5 

  • page. Optional. Specifies the page of results to retrieve. Note: there are pagination limits.

    • Example: http://api.twitter.com/1/statuses/retweets_of_me.xml?page=3

 

Response (about return values): 

          XML example (truncated):

<?xml version="1.0" encoding="UTF-8"?>
<statuses type="array">
<status>
  <created_at>Tue Nov 10 23:19:35 +0000 2009</created_at>
  <id>5602737633</id>
  <text>OH: "If you happen to see the SFPD Bomb Squad parked out front of our building, no need to panic or worry."</text>
  <source><a href="http://www.atebits.com/" rel="nofollow">Tweetie</a></source>
  <truncated>false</truncated>
  <in_reply_to_status_id></in_reply_to_status_id>
  <in_reply_to_user_id></in_reply_to_user_id>
  <favorited>false</favorited>
  <in_reply_to_screen_name></in_reply_to_screen_name>
  <user>
    <id>3191321</id>
    <name>Marcel Molina</name>
    <screen_name>noradio</screen_name>
    <location>San Francisco, CA</location>
    <description>Engineer at Twitter on the @twitterapi team, obsessed with rock climbing & running. In a past life I was a member of the Rails Core team.</description>
    <profile_image_url>http://a3.twimg.com/profile_images/53473799/marcel-euro-rails-conf_normal.jpg</profile_image_url>
    <url>http://project.ioni.st</url>
    <protected>false</protected>
    <followers_count>118243</followers_count>
    <profile_background_color>9AE4E8</profile_background_color>
    <profile_text_color>333333</profile_text_color>
    <profile_link_color>0084B4</profile_link_color>
    <profile_sidebar_fill_color>DDFFCC</profile_sidebar_fill_color>
    <profile_sidebar_border_color>BDDCAD</profile_sidebar_border_color>
    <friends_count>359</friends_count>
    <created_at>Mon Apr 02 07:47:28 +0000 2007</created_at>
    <favourites_count>136</favourites_count>
    <utc_offset>-28800</utc_offset>
    <time_zone>Pacific Time (US & Canada)</time_zone>
    <profile_background_image_url>http://a1.twimg.com/profile_background_images/18156348/jessica_tiled.jpg.jpeg</profile_background_image_url>
    <profile_background_tile>true</profile_background_tile>
    <statuses_count>3538</statuses_count>
    <notifications>false</notifications>
    <geo_enabled>true</geo_enabled>
    <verified>false</verified>
    <following>false</following>
  </user>
  <geo/>
</status>
<status>
  <created_at>Sun Oct 25 19:58:03 +0000 2009</created_at>
  <id>5154306544</id>
  <text>The problem with having really secure passwords is that I'm so proud of them I want to show them to everyone.</text>
  <source><a href="http://www.atebits.com/" rel="nofollow">Tweetie</a></source>
  <truncated>false</truncated>
  <in_reply_to_status_id></in_reply_to_status_id>
  <in_reply_to_user_id></in_reply_to_user_id>
  <favorited>false</favorited>
  <in_reply_to_screen_name></in_reply_to_screen_name>
  <user>
    <id>3191321</id>
    <name>Marcel Molina</name>
    <screen_name>noradio</screen_name>
    <location>San Francisco, CA</location>
    <description>Engineer at Twitter on the @twitterapi team, obsessed with rock climbing & running. In a past life I was a member of the Rails Core team.</description>
    <profile_image_url>http://a3.twimg.com/profile_images/53473799/marcel-euro-rails-conf_normal.jpg</profile_image_url>
    <url>http://project.ioni.st</url>
    <protected>false</protected>
    <followers_count>112595</followers_count>
    <profile_background_color>9AE4E8</profile_background_color>
    <profile_text_color>333333</profile_text_color>
    <profile_link_color>0084B4</profile_link_color>
    <profile_sidebar_fill_color>DDFFCC</profile_sidebar_fill_color>
    <profile_sidebar_border_color>BDDCAD</profile_sidebar_border_color>
    <friends_count>358</friends_count>
    <created_at>Mon Apr 02 07:47:28 +0000 2007</created_at>
    <favourites_count>136</favourites_count>
    <utc_offset>-28800</utc_offset>
    <time_zone>Pacific Time (US & Canada)</time_zone>
    <profile_background_image_url>http://a1.twimg.com/profile_background_images/18156348/jessica_tiled.jpg.jpeg</profile_background_image_url>
    <profile_background_tile>true</profile_background_tile>
    <statuses_count>3535</statuses_count>
    <notifications>false</notifications>
    <geo_enabled>true</geo_enabled>
    <verified>false</verified>
    <following>false</following>
  </user>
  <geo/>
</status>
<!-- etc -->

</statuses>

Usage examples: 

cURL (about cURL):

curl -u user:password http://api.twitter.com/1/statuses/retweets_of_me.xml

 

          Do you have an example to share in the language of your choice? Please share!

 

 

 

 

Comments (0)

You don't have permission to comment on this page.

Printable version
 
Anonymous Create an account or Log in