GET statuses/retweeted_by_me

Updated on Fri, 2012-10-12 10:37

Returns the 20 most recent retweets posted by the authenticating user.

Resource URL

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

Parameters

count optional

Specifies the number of records to retrieve. Must be less than or equal to 100.

Example Values: 5

since_id optional

Returns results with an ID greater than (that is, more recent than) the specified ID. There are limits to the number of Tweets which can be accessed through the API. If the limit of Tweets has occured since the since_id, the since_id will be forced to the oldest ID available.

Example Values: 12345

max_id optional

Returns results with an ID less than (that is, older than) or equal to the specified ID.

Example Values: 54321

page optional

This parameter will soon cease to be functional See Working with Timelines.

Specifies the page of results to retrieve.

Example Values: 3

trim_user optional

When set to either true, t or 1, each tweet returned in a timeline will include a user object including only the status authors numerical ID. Omit this parameter to receive the complete user object.

Example Values: true

include_entities optional

When set to either true, t or 1, each tweet will include a node called "entities,". This node offers a variety of metadata about the tweet in a discreet structure, including: user_mentions, urls, and hashtags. While entities are opt-in on timelines at present, they will be made a default component of output in the future. See Tweet Entities for more detail on entities.

Example Values: true

Example Request

GET

https://api.twitter.com/1/statuses/retweeted_by_me.json?include_entities=true&count=3

  1. [
  2.   {
  3.     "coordinates": null,
  4.     "truncated": false,
  5.     "created_at": "Thu Jan 06 20:28:25 +0000 2011",
  6.     "favorited": false,
  7.     "retweeted_status": {
  8.       "coordinates": null,
  9.       "truncated": false,
  10.       "created_at": "Thu Jan 06 17:57:20 +0000 2011",
  11.       "favorited": false,
  12.       "id_str": "23075657323905024",
  13.       "entities": {
  14.         "places": [
  15.  
  16.         ],
  17.         "urls": [
  18.           {
  19.             "expanded_url": null,
  20.             "url": "http://is.gd/kf3BH",
  21.             "indices": [
  22.               84,
  23.               102
  24.             ]
  25.           }
  26.         ],
  27.         "hashtags": [
  28.  
  29.         ],
  30.         "user_mentions": [
  31.           {
  32.             "name": "Thrill Jockey",
  33.             "id_str": "20640619",
  34.             "id": 20640619,
  35.             "indices": [
  36.               103,
  37.               116
  38.             ],
  39.             "screen_name": "thrilljockey"
  40.           }
  41.         ]
  42.       },
  43.       "in_reply_to_user_id_str": null,
  44.       "annotations": null,
  45.       "contributors": null,
  46.       "text": "Tortoise + Colin Newman (of Wire) BBC session is on Archive.org! Love this session! http://is.gd/kf3BH @thrilljockey",
  47.       "id": 23075657323905024,
  48.       "retweet_count": 4,
  49.       "in_reply_to_status_id_str": null,
  50.       "geo": null,
  51.       "retweeted": false,
  52.       "in_reply_to_user_id": null,
  53.       "user": {
  54.         "name": "mikeroeder",
  55.         "profile_background_tile": true,
  56.         "profile_sidebar_fill_color": "DDFFCC",
  57.         "profile_sidebar_border_color": "BDDCAD",
  58.         "location": "iPhone: 45.075680,-93.198822",
  59.         "profile_image_url": "http://a2.twimg.com/profile_images/76286129/me_normal.jpg",
  60.         "created_at": "Mon Dec 01 13:36:58 +0000 2008",
  61.         "profile_link_color": "0084B4",
  62.         "follow_request_sent": false,
  63.         "is_translator": false,
  64.         "id_str": "17778714",
  65.         "contributors_enabled": false,
  66.         "favourites_count": 0,
  67.         "url": "http://www.playbsides.com",
  68.         "utc_offset": -21600,
  69.         "id": 17778714,
  70.         "profile_use_background_image": true,
  71.         "listed_count": 13,
  72.         "protected": false,
  73.         "followers_count": 260,
  74.         "profile_text_color": "333333",
  75.         "lang": "en",
  76.         "geo_enabled": false,
  77.         "time_zone": "Central Time (US & Canada)",
  78.         "verified": false,
  79.         "notifications": false,
  80.         "profile_background_color": "9AE4E8",
  81.         "description": "I'm a huge music fan and run a blog about it.",
  82.         "friends_count": 193,
  83.         "profile_background_image_url": "http://a2.twimg.com/profile_background_images/4320755/records.jpg",
  84.         "statuses_count": 2891,
  85.         "show_all_inline_media": false,
  86.         "screen_name": "mikeroeder",
  87.         "following": false
  88.       },
  89.       "source": "web",
  90.       "place": null,
  91.       "in_reply_to_screen_name": null,
  92.       "in_reply_to_status_id": null
  93.     },
  94.     "id_str": "23113679230738432",
  95.     "entities": {
  96.       "places": [
  97.  
  98.       ],
  99.       "urls": [
  100.         {
  101.           "expanded_url": null,
  102.           "url": "http://is.gd/kf3BH",
  103.           "indices": [
  104.             100,
  105.             118
  106.           ]
  107.         }
  108.       ],
  109.       "hashtags": [
  110.  
  111.       ],
  112.       "user_mentions": [
  113.         {
  114.           "name": "mikeroeder",
  115.           "id_str": "17778714",
  116.           "id": 17778714,
  117.           "indices": [
  118.             3,
  119.             14
  120.           ],
  121.           "screen_name": "mikeroeder"
  122.         },
  123.         {
  124.           "name": "Thrill Jockey",
  125.           "id_str": "20640619",
  126.           "id": 20640619,
  127.           "indices": [
  128.             119,
  129.             132
  130.           ],
  131.           "screen_name": "thrilljockey"
  132.         }
  133.       ]
  134.     },
  135.     "in_reply_to_user_id_str": null,
  136.     "annotations": null,
  137.     "contributors": null,
  138.     "text": "RT @mikeroeder: Tortoise + Colin Newman (of Wire) BBC session is on Archive.org! Love this session! http://is.gd/kf3BH @thrilljockey",
  139.     "id": 23113679230738432,
  140.     "retweet_count": 4,
  141.     "in_reply_to_status_id_str": null,
  142.     "geo": null,
  143.     "retweeted": false,
  144.     "in_reply_to_user_id": null,
  145.     "user": {
  146.       "name": "Taylor Singletary",
  147.       "profile_background_tile": false,
  148.       "profile_sidebar_fill_color": "000b17",
  149.       "expanded_url": "http://bit.ly/5w7P88",
  150.       "profile_sidebar_border_color": "f7b565",
  151.       "location": "iPhone: 37.778189,-122.397936",
  152.       "profile_image_url": "http://a2.twimg.com/profile_images/1207553010/twitter-ecosystem-avatar_normal.jpg",
  153.       "created_at": "Wed Mar 07 22:23:19 +0000 2007",
  154.       "profile_link_color": "448668",
  155.       "follow_request_sent": false,
  156.       "is_translator": false,
  157.       "id_str": "819797",
  158.       "entities": {
  159.         "urls": [
  160.  
  161.         ],
  162.         "hashtags": [
  163.  
  164.         ],
  165.         "user_mentions": [
  166.  
  167.         ]
  168.       },
  169.       "contributors_enabled": false,
  170.       "favourites_count": 1814,
  171.       "url": "http://t.co/dapZGV0",
  172.       "utc_offset": -28800,
  173.       "id": 819797,
  174.       "profile_use_background_image": true,
  175.       "listed_count": 192,
  176.       "protected": false,
  177.       "followers_count": 2652,
  178.       "profile_text_color": "004358",
  179.       "lang": "en",
  180.       "geo_enabled": true,
  181.       "time_zone": "Pacific Time (US & Canada)",
  182.       "verified": false,
  183.       "notifications": false,
  184.       "profile_background_color": "001329",
  185.       "description": "Reality Technician, Developer Advocate at Twitter, Eater of Worlds.",
  186.       "friends_count": 2212,
  187.       "profile_background_image_url": "http://a1.twimg.com/profile_background_images/174206644/nasa9_792_31420.jpg",
  188.       "statuses_count": 8891,
  189.       "display_url": "bit.ly/5w7P88",
  190.       "show_all_inline_media": true,
  191.       "screen_name": "episod",
  192.       "following": true
  193.     },
  194.     "source": "<a href=\"http://sites.google.com/site/yorufukurou/\" rel=\"nofollow\">YoruFukurou</a>",
  195.     "place": null,
  196.     "in_reply_to_screen_name": null,
  197.     "in_reply_to_status_id": null
  198.   },
  199.   {
  200.     "coordinates": null,
  201.     "truncated": false,
  202.     "created_at": "Thu Jan 06 20:11:59 +0000 2011",
  203.     "favorited": false,
  204.     "retweeted_status": {
  205.       "coordinates": null,
  206.       "truncated": false,
  207.       "created_at": "Thu Jan 06 20:10:47 +0000 2011",
  208.       "favorited": false,
  209.       "id_str": "23109241439002624",
  210.       "entities": {
  211.         "places": [
  212.  
  213.         ],
  214.         "urls": [
  215.           {
  216.             "expanded_url": "http://tcrn.ch/gkwDjX",
  217.             "url": "http://t.co/V1r3OIJ",
  218.             "indices": [
  219.               81,
  220.               100
  221.             ],
  222.             "display_url": "tcrn.ch/gkwDjX"
  223.           }
  224.         ],
  225.         "hashtags": [
  226.  
  227.         ],
  228.         "user_mentions": [
  229.  
  230.         ]
  231.       },
  232.       "in_reply_to_user_id_str": null,
  233.       "annotations": null,
  234.       "contributors": null,
  235.       "text": "Forget Apple Keynotes, Japan\u2019s New Year Sets Record With 6,939 Tweets Per\u00a0Second http://t.co/V1r3OIJ",
  236.       "id": 23109241439002624,
  237.       "retweet_count": 5,
  238.       "in_reply_to_status_id_str": null,
  239.       "geo": null,
  240.       "retweeted": false,
  241.       "in_reply_to_user_id": null,
  242.       "user": {
  243.         "name": "MG Siegler",
  244.         "profile_background_tile": true,
  245.         "profile_sidebar_fill_color": "F5CB71",
  246.         "profile_sidebar_border_color": "3E3F40",
  247.         "location": "San Francisco",
  248.         "profile_image_url": "http://a2.twimg.com/profile_images/1170518828/Screen_shot_2010-11-18_at_7.31.18_PM_normal.png",
  249.         "created_at": "Wed Jan 17 04:27:29 +0000 2007",
  250.         "profile_link_color": "C58500",
  251.         "follow_request_sent": false,
  252.         "id_str": "652193",
  253.         "is_translator": false,
  254.         "contributors_enabled": false,
  255.         "favourites_count": 2685,
  256.         "url": "http://parislemon.com",
  257.         "utc_offset": -28800,
  258.         "id": 652193,
  259.         "profile_use_background_image": true,
  260.         "listed_count": 2736,
  261.         "protected": false,
  262.         "followers_count": 31260,
  263.         "profile_text_color": "730028",
  264.         "lang": "en",
  265.         "verified": true,
  266.         "time_zone": "Pacific Time (US & Canada)",
  267.         "notifications": false,
  268.         "profile_background_color": "801818",
  269.         "description": "He of @TechCrunch. I roam the badlands. An outlaw hunting outlaws. A renegade.",
  270.         "geo_enabled": true,
  271.         "statuses_count": 17145,
  272.         "friends_count": 892,
  273.         "profile_background_image_url": "http://a0.twimg.com/profile_background_images/187663015/x805ddcc809798f44904aab223f71dd4.png",
  274.         "screen_name": "parislemon",
  275.         "following": false,
  276.         "show_all_inline_media": true
  277.       },
  278.       "source": "<a href=\"http://twitter.com/tweetbutton\" rel=\"nofollow\">Tweet Button</a>",
  279.       "place": null,
  280.       "in_reply_to_screen_name": null,
  281.       "in_reply_to_status_id": null
  282.     },
  283.     "id_str": "23109546562035713",
  284.     "entities": {
  285.       "places": [
  286.  
  287.       ],
  288.       "urls": [
  289.         {
  290.           "expanded_url": "http://tcrn.ch/gkwDjX",
  291.           "url": "http://t.co/V1r3OIJ",
  292.           "indices": [
  293.             97,
  294.             116
  295.           ],
  296.           "display_url": "tcrn.ch/gkwDjX"
  297.         }
  298.       ],
  299.       "hashtags": [
  300.  
  301.       ],
  302.       "user_mentions": [
  303.         {
  304.           "name": "MG Siegler",
  305.           "id_str": "652193",
  306.           "id": 652193,
  307.           "indices": [
  308.             3,
  309.             14
  310.           ],
  311.           "screen_name": "parislemon"
  312.         }
  313.       ]
  314.     },
  315.     "in_reply_to_user_id_str": null,
  316.     "annotations": null,
  317.     "contributors": null,
  318.     "text": "RT @parislemon: Forget Apple Keynotes, Japan\u2019s New Year Sets Record With 6,939 Tweets Per\u00a0Second http://t.co/V1r3OIJ",
  319.     "id": 23109546562035713,
  320.     "retweet_count": 5,
  321.     "in_reply_to_status_id_str": null,
  322.     "geo": null,
  323.     "retweeted": false,
  324.     "in_reply_to_user_id": null,
  325.     "user": {
  326.       "name": "Taylor Singletary",
  327.       "profile_background_tile": false,
  328.       "profile_sidebar_fill_color": "000b17",
  329.       "expanded_url": "http://bit.ly/5w7P88",
  330.       "profile_sidebar_border_color": "f7b565",
  331.       "location": "iPhone: 37.778189,-122.397936",
  332.       "profile_image_url": "http://a2.twimg.com/profile_images/1207553010/twitter-ecosystem-avatar_normal.jpg",
  333.       "created_at": "Wed Mar 07 22:23:19 +0000 2007",
  334.       "profile_link_color": "448668",
  335.       "follow_request_sent": false,
  336.       "id_str": "819797",
  337.       "is_translator": false,
  338.       "entities": {
  339.         "urls": [
  340.  
  341.         ],
  342.         "hashtags": [
  343.  
  344.         ],
  345.         "user_mentions": [
  346.  
  347.         ]
  348.       },
  349.       "contributors_enabled": false,
  350.       "favourites_count": 1812,
  351.       "url": "http://t.co/dapZGV0",
  352.       "utc_offset": -28800,
  353.       "id": 819797,
  354.       "profile_use_background_image": true,
  355.       "listed_count": 192,
  356.       "protected": false,
  357.       "followers_count": 2652,
  358.       "profile_text_color": "004358",
  359.       "lang": "en",
  360.       "verified": false,
  361.       "time_zone": "Pacific Time (US & Canada)",
  362.       "notifications": false,
  363.       "profile_background_color": "001329",
  364.       "description": "Reality Technician, Developer Advocate at Twitter, Eater of Worlds.",
  365.       "geo_enabled": true,
  366.       "statuses_count": 8888,
  367.       "friends_count": 2212,
  368.       "profile_background_image_url": "http://a1.twimg.com/profile_background_images/174206644/nasa9_792_31420.jpg",
  369.       "display_url": "bit.ly/5w7P88",
  370.       "screen_name": "episod",
  371.       "following": true,
  372.       "show_all_inline_media": true
  373.     },
  374.     "source": "<a href=\"http://sites.google.com/site/yorufukurou/\" rel=\"nofollow\">YoruFukurou</a>",
  375.     "place": null,
  376.     "in_reply_to_screen_name": null,
  377.     "in_reply_to_status_id": null
  378.   },
  379.   {
  380.     "coordinates": null,
  381.     "truncated": false,
  382.     "created_at": "Thu Jan 06 17:41:09 +0000 2011",
  383.     "favorited": false,
  384.     "id_str": "23071584537288704",
  385.     "retweeted_status": {
  386.       "coordinates": null,
  387.       "truncated": false,
  388.       "created_at": "Thu Jan 06 15:21:17 +0000 2011",
  389.       "favorited": false,
  390.       "id_str": "23036386575646720",
  391.       "in_reply_to_user_id_str": null,
  392.       "entities": {
  393.         "places": [
  394.  
  395.         ],
  396.         "urls": [
  397.           {
  398.             "expanded_url": null,
  399.             "url": "http://docs.php.net/",
  400.             "indices": [
  401.               54,
  402.               74
  403.             ]
  404.           }
  405.         ],
  406.         "hashtags": [
  407.  
  408.         ],
  409.         "user_mentions": [
  410.  
  411.         ]
  412.       },
  413.       "annotations": null,
  414.       "contributors": null,
  415.       "text": "Check out the new PHP docs website. It looks awesome! http://docs.php.net/",
  416.       "id": 23036386575646720,
  417.       "retweet_count": 62,
  418.       "in_reply_to_status_id_str": null,
  419.       "geo": null,
  420.       "retweeted": false,
  421.       "in_reply_to_user_id": null,
  422.       "user": {
  423.         "name": "PHP Community",
  424.         "profile_sidebar_border_color": "333333",
  425.         "profile_background_tile": false,
  426.         "profile_sidebar_fill_color": "d4d5e8",
  427.         "profile_image_url": "http://a2.twimg.com/profile_images/1189965921/PHP_C_Logo_normal.png",
  428.         "location": "#phpc on Freenode IRC",
  429.         "created_at": "Tue Dec 09 18:05:32 +0000 2008",
  430.         "is_translator": false,
  431.         "id_str": "17997273",
  432.         "profile_link_color": "333366",
  433.         "follow_request_sent": false,
  434.         "favourites_count": 0,
  435.         "url": "http://phpcommunity.org/",
  436.         "contributors_enabled": false,
  437.         "utc_offset": -18000,
  438.         "id": 17997273,
  439.         "listed_count": 543,
  440.         "profile_use_background_image": true,
  441.         "protected": false,
  442.         "lang": "en",
  443.         "followers_count": 7437,
  444.         "profile_text_color": "333333",
  445.         "verified": false,
  446.         "profile_background_color": "000000",
  447.         "notifications": false,
  448.         "time_zone": "Eastern Time (US & Canada)",
  449.         "description": "PHPC is a gathering place for the PHP community. It is about community and friendship.",
  450.         "geo_enabled": false,
  451.         "profile_background_image_url": "http://a3.twimg.com/profile_background_images/3561102/php2.png",
  452.         "friends_count": 3994,
  453.         "statuses_count": 532,
  454.         "screen_name": "phpc",
  455.         "following": false,
  456.         "show_all_inline_media": false
  457.       },
  458.       "source": "<a href=\"http://www.echofon.com/\" rel=\"nofollow\">Echofon</a>",
  459.       "place": null,
  460.       "in_reply_to_screen_name": null,
  461.       "in_reply_to_status_id": null
  462.     },
  463.     "in_reply_to_user_id_str": null,
  464.     "entities": {
  465.       "places": [
  466.  
  467.       ],
  468.       "urls": [
  469.         {
  470.           "expanded_url": null,
  471.           "url": "http://docs.php.net/",
  472.           "indices": [
  473.             64,
  474.             84
  475.           ]
  476.         }
  477.       ],
  478.       "hashtags": [
  479.  
  480.       ],
  481.       "user_mentions": [
  482.         {
  483.           "name": "PHP Community",
  484.           "id_str": "17997273",
  485.           "id": 17997273,
  486.           "indices": [
  487.             3,
  488.             8
  489.           ],
  490.           "screen_name": "phpc"
  491.         }
  492.       ]
  493.     },
  494.     "annotations": null,
  495.     "contributors": null,
  496.     "text": "RT @phpc: Check out the new PHP docs website. It looks awesome! http://docs.php.net/",
  497.     "id": 23071584537288704,
  498.     "retweet_count": 62,
  499.     "in_reply_to_status_id_str": null,
  500.     "geo": null,
  501.     "retweeted": false,
  502.     "in_reply_to_user_id": null,
  503.     "user": {
  504.       "name": "Taylor Singletary",
  505.       "profile_sidebar_border_color": "f7b565",
  506.       "expanded_url": "http://bit.ly/5w7P88",
  507.       "profile_background_tile": false,
  508.       "profile_sidebar_fill_color": "000b17",
  509.       "profile_image_url": "http://a2.twimg.com/profile_images/1207553010/twitter-ecosystem-avatar_normal.jpg",
  510.       "location": "iPhone: 37.778189,-122.397936",
  511.       "created_at": "Wed Mar 07 22:23:19 +0000 2007",
  512.       "is_translator": false,
  513.       "id_str": "819797",
  514.       "profile_link_color": "448668",
  515.       "follow_request_sent": false,
  516.       "entities": {
  517.         "urls": [
  518.  
  519.         ],
  520.         "hashtags": [
  521.  
  522.         ],
  523.         "user_mentions": [
  524.  
  525.         ]
  526.       },
  527.       "favourites_count": 1809,
  528.       "url": "http://t.co/dapZGV0",
  529.       "contributors_enabled": false,
  530.       "utc_offset": -28800,
  531.       "id": 819797,
  532.       "listed_count": 192,
  533.       "profile_use_background_image": true,
  534.       "protected": false,
  535.       "lang": "en",
  536.       "followers_count": 2650,
  537.       "profile_text_color": "004358",
  538.       "verified": false,
  539.       "profile_background_color": "001329",
  540.       "notifications": false,
  541.       "time_zone": "Pacific Time (US & Canada)",
  542.       "description": "Reality Technician, Developer Advocate at Twitter, Eater of Worlds.",
  543.       "geo_enabled": true,
  544.       "profile_background_image_url": "http://a1.twimg.com/profile_background_images/174206644/nasa9_792_31420.jpg",
  545.       "display_url": "bit.ly/5w7P88",
  546.       "friends_count": 2213,
  547.       "statuses_count": 8886,
  548.       "screen_name": "episod",
  549.       "following": true,
  550.       "show_all_inline_media": true
  551.     },
  552.     "source": "<a href=\"http://sites.google.com/site/yorufukurou/\" rel=\"nofollow\">YoruFukurou</a>",
  553.     "place": null,
  554.     "in_reply_to_screen_name": null,
  555.     "in_reply_to_status_id": null
  556.   }
  557. ]