GET statuses/retweeted_to_user

Updated on Thu, 2012-05-10 14:20

Returns the 20 most recent retweets posted by users the specified user follows. The user is specified using the user_id or screen_name parameters. This method is identical to statuses/retweeted_to_me except you can choose the user to view.

Resource URL

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

Parameters

A screen_name or user_id is requried.

screen_name optional

The screen name of the user for whom to return results for. Helpful for disambiguating when a valid screen name is also a user ID.

Example Values: noradio

id optional

The ID or screen name of the user for whom to return results for. Note this isn't a query string parameter but a change to the end of the URL.

Example Values: 12345, noradio

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_to_user.json?screen_name=twitterapi&count=3

  1. [
  2.   {
  3.     "coordinates": null,
  4.     "created_at": "Tue Jan 25 17:19:35 +0000 2011",
  5.     "favorited": false,
  6.     "truncated": false,
  7.     "id_str": "29951527158292480",
  8.     "retweeted_status": {
  9.       "coordinates": null,
  10.       "created_at": "Tue Jan 25 15:10:21 +0000 2011",
  11.       "favorited": false,
  12.       "truncated": false,
  13.       "id_str": "29919003753316353",
  14.       "in_reply_to_user_id_str": null,
  15.       "contributors": null,
  16.       "annotations": null,
  17.       "text": "Verizon CEO confirms $30 unlimited data plan for iPhone 4 http://goo.gl/fb/LgEgi",
  18.       "id": 29919003753316353,
  19.       "retweet_count": 52,
  20.       "in_reply_to_status_id_str": null,
  21.       "geo": null,
  22.       "retweeted": false,
  23.       "in_reply_to_user_id": null,
  24.       "user": {
  25.         "profile_sidebar_border_color": "215696",
  26.         "name": "BGR",
  27.         "profile_background_tile": true,
  28.         "profile_sidebar_fill_color": "ffffff",
  29.         "created_at": "Mon Dec 15 04:56:14 +0000 2008",
  30.         "profile_image_url": "http://a0.twimg.com/profile_images/1159835095/bgr-twitter_normal.png",
  31.         "location": "New York, NY",
  32.         "follow_request_sent": false,
  33.         "id_str": "18131006",
  34.         "profile_link_color": "23649e",
  35.         "is_translator": false,
  36.         "favourites_count": 0,
  37.         "contributors_enabled": false,
  38.         "url": "http://www.bgr.com",
  39.         "utc_offset": -18000,
  40.         "id": 18131006,
  41.         "listed_count": 2896,
  42.         "profile_use_background_image": false,
  43.         "lang": "en",
  44.         "protected": false,
  45.         "profile_text_color": "000000",
  46.         "followers_count": 33539,
  47.         "geo_enabled": false,
  48.         "verified": false,
  49.         "time_zone": "Eastern Time (US & Canada)",
  50.         "description": "",
  51.         "profile_background_color": "ebebeb",
  52.         "notifications": false,
  53.         "friends_count": 3,
  54.         "statuses_count": 6253,
  55.         "profile_background_image_url": "http://a3.twimg.com/profile_background_images/3603835/bgrradio2.jpg",
  56.         "show_all_inline_media": false,
  57.         "screen_name": "BGR",
  58.         "following": true
  59.       },
  60.       "source": "<a href=\"http://www.google.com/support/youtube/bin/answer.py?hl=en&answer=164577\" rel=\"nofollow\">Google</a>",
  61.       "place": null,
  62.       "in_reply_to_screen_name": null,
  63.       "in_reply_to_status_id": null
  64.     },
  65.     "in_reply_to_user_id_str": null,
  66.     "contributors": null,
  67.     "annotations": null,
  68.     "text": "RT @BGR: Verizon CEO confirms $30 unlimited data plan for iPhone 4 http://goo.gl/fb/LgEgi",
  69.     "id": 29951527158292480,
  70.     "retweet_count": 52,
  71.     "in_reply_to_status_id_str": null,
  72.     "geo": null,
  73.     "retweeted": false,
  74.     "in_reply_to_user_id": null,
  75.     "user": {
  76.       "profile_sidebar_border_color": "38301f",
  77.       "name": "Kelton Lynn",
  78.       "profile_background_tile": false,
  79.       "profile_sidebar_fill_color": "38301f",
  80.       "expanded_url": null,
  81.       "created_at": "Mon Mar 30 16:30:42 +0000 2009",
  82.       "profile_image_url": "http://a3.twimg.com/profile_images/384067053/n209356_35266280_356207_2_normal.jpg",
  83.       "location": "23.010768,-109.721906",
  84.       "follow_request_sent": false,
  85.       "id_str": "27674040",
  86.       "profile_link_color": "9e9070",
  87.       "is_translator": false,
  88.       "entities": {
  89.         "urls": [
  90.  
  91.         ],
  92.         "hashtags": [
  93.  
  94.         ],
  95.         "user_mentions": [
  96.  
  97.         ]
  98.       },
  99.       "favourites_count": 20,
  100.       "contributors_enabled": false,
  101.       "url": null,
  102.       "utc_offset": -28800,
  103.       "id": 27674040,
  104.       "listed_count": 84,
  105.       "profile_use_background_image": true,
  106.       "lang": "en",
  107.       "protected": false,
  108.       "profile_text_color": "6e624b",
  109.       "followers_count": 2034,
  110.       "geo_enabled": true,
  111.       "verified": false,
  112.       "time_zone": "Pacific Time (US & Canada)",
  113.       "description": "Mobile BizDev at Twitter, former Boulderite, bleed Cardinal, SF transplant, love athletics/competition, consumer tech, entrepreneurship, family/friends...life",
  114.       "profile_background_color": "38301f",
  115.       "notifications": false,
  116.       "friends_count": 633,
  117.       "display_url": null,
  118.       "statuses_count": 1248,
  119.       "profile_background_image_url": "http://a0.twimg.com/profile_background_images/105179201/boulder_181_10949.jpg",
  120.       "show_all_inline_media": true,
  121.       "screen_name": "keltonlynn",
  122.       "following": false
  123.     },
  124.     "source": "<a href=\"http://www.flipboard.com\" rel=\"nofollow\">Flipboard</a>",
  125.     "place": null,
  126.     "in_reply_to_screen_name": null,
  127.     "in_reply_to_status_id": null
  128.   },
  129.   {
  130.     "coordinates": null,
  131.     "created_at": "Tue Jan 25 16:57:45 +0000 2011",
  132.     "favorited": false,
  133.     "truncated": false,
  134.     "id_str": "29946032213200896",
  135.     "retweeted_status": {
  136.       "coordinates": null,
  137.       "created_at": "Tue Jan 25 16:12:40 +0000 2011",
  138.       "favorited": false,
  139.       "truncated": false,
  140.       "id_str": "29934689351372801",
  141.       "in_reply_to_user_id_str": null,
  142.       "contributors": null,
  143.       "annotations": null,
  144.       "text": "The brilliance, craziness and cockiness of emerging market entrepreneurs http://bit.ly/fVvl2M",
  145.       "id": 29934689351372801,
  146.       "retweet_count": 16,
  147.       "in_reply_to_status_id_str": null,
  148.       "geo": null,
  149.       "retweeted": false,
  150.       "in_reply_to_user_id": null,
  151.       "in_reply_to_screen_name": null,
  152.       "user": {
  153.         "name": "Fortune Magazine",
  154.         "profile_sidebar_border_color": "a8c7f7",
  155.         "profile_background_tile": false,
  156.         "profile_sidebar_fill_color": "C0DFEC",
  157.         "created_at": "Wed Mar 18 10:23:54 +0000 2009",
  158.         "profile_image_url": "http://a0.twimg.com/profile_images/1017887593/Fortune_Icon_57x57_normal.png",
  159.         "location": "New York",
  160.         "is_translator": false,
  161.         "id_str": "25053299",
  162.         "profile_link_color": "0084B4",
  163.         "follow_request_sent": false,
  164.         "contributors_enabled": true,
  165.         "favourites_count": 2,
  166.         "url": "http://fortune.com",
  167.         "utc_offset": -18000,
  168.         "id": 25053299,
  169.         "profile_use_background_image": true,
  170.         "listed_count": 5504,
  171.         "lang": "en",
  172.         "followers_count": 251445,
  173.         "protected": false,
  174.         "profile_text_color": "333333",
  175.         "profile_background_color": "022330",
  176.         "time_zone": "Eastern Time (US & Canada)",
  177.         "geo_enabled": true,
  178.         "description": "FORTUNE's official Twitter feed. Here's what we're hearing, seeing, reading and writing. Visit us at http://www.fortune.com",
  179.         "notifications": false,
  180.         "verified": true,
  181.         "statuses_count": 5893,
  182.         "friends_count": 211,
  183.         "profile_background_image_url": "http://a2.twimg.com/profile_background_images/80439092/NEWTwitter4.gif",
  184.         "screen_name": "FortuneMagazine",
  185.         "following": true,
  186.         "show_all_inline_media": false
  187.       },
  188.       "source": "<a href=\"http://www.tweetdeck.com\" rel=\"nofollow\">TweetDeck</a>",
  189.       "place": null,
  190.       "in_reply_to_status_id": null
  191.     },
  192.     "in_reply_to_user_id_str": null,
  193.     "contributors": null,
  194.     "annotations": null,
  195.     "text": "RT @FortuneMagazine: The brilliance, craziness and cockiness of emerging market entrepreneurs http://bit.ly/fVvl2M",
  196.     "id": 29946032213200896,
  197.     "retweet_count": 16,
  198.     "in_reply_to_status_id_str": null,
  199.     "geo": null,
  200.     "retweeted": false,
  201.     "in_reply_to_user_id": null,
  202.     "in_reply_to_screen_name": null,
  203.     "user": {
  204.       "name": "Kelton Lynn",
  205.       "profile_sidebar_border_color": "38301f",
  206.       "profile_background_tile": false,
  207.       "profile_sidebar_fill_color": "38301f",
  208.       "expanded_url": null,
  209.       "created_at": "Mon Mar 30 16:30:42 +0000 2009",
  210.       "profile_image_url": "http://a3.twimg.com/profile_images/384067053/n209356_35266280_356207_2_normal.jpg",
  211.       "location": "23.010768,-109.721906",
  212.       "is_translator": false,
  213.       "id_str": "27674040",
  214.       "profile_link_color": "9e9070",
  215.       "follow_request_sent": false,
  216.       "entities": {
  217.         "urls": [
  218.  
  219.         ],
  220.         "hashtags": [
  221.  
  222.         ],
  223.         "user_mentions": [
  224.  
  225.         ]
  226.       },
  227.       "contributors_enabled": false,
  228.       "favourites_count": 20,
  229.       "url": null,
  230.       "utc_offset": -28800,
  231.       "id": 27674040,
  232.       "profile_use_background_image": true,
  233.       "listed_count": 84,
  234.       "lang": "en",
  235.       "followers_count": 2034,
  236.       "protected": false,
  237.       "profile_text_color": "6e624b",
  238.       "profile_background_color": "38301f",
  239.       "time_zone": "Pacific Time (US & Canada)",
  240.       "geo_enabled": true,
  241.       "description": "Mobile BizDev at Twitter, former Boulderite, bleed Cardinal, SF transplant, love athletics/competition, consumer tech, entrepreneurship, family/friends...life",
  242.       "notifications": false,
  243.       "verified": false,
  244.       "display_url": null,
  245.       "statuses_count": 1247,
  246.       "friends_count": 633,
  247.       "profile_background_image_url": "http://a0.twimg.com/profile_background_images/105179201/boulder_181_10949.jpg",
  248.       "screen_name": "keltonlynn",
  249.       "following": false,
  250.       "show_all_inline_media": true
  251.     },
  252.     "source": "<a href=\"http://www.flipboard.com\" rel=\"nofollow\">Flipboard</a>",
  253.     "place": null,
  254.     "in_reply_to_status_id": null
  255.   },
  256.   {
  257.     "coordinates": null,
  258.     "created_at": "Tue Jan 25 16:44:07 +0000 2011",
  259.     "favorited": false,
  260.     "truncated": false,
  261.     "id_str": "29942603927519235",
  262.     "retweeted_status": {
  263.       "coordinates": null,
  264.       "created_at": "Tue Jan 25 16:17:24 +0000 2011",
  265.       "favorited": false,
  266.       "truncated": false,
  267.       "id_str": "29935880189779968",
  268.       "in_reply_to_user_id_str": null,
  269.       "contributors": null,
  270.       "annotations": null,
  271.       "text": "According to @techcrunch, Twitter is #1 referrer in 2010!  http://t.co/YBokP0g",
  272.       "id": 29935880189779968,
  273.       "retweet_count": 0,
  274.       "in_reply_to_status_id_str": null,
  275.       "geo": null,
  276.       "retweeted": false,
  277.       "in_reply_to_user_id": null,
  278.       "in_reply_to_screen_name": null,
  279.       "user": {
  280.         "name": "Hongzhe Sun",
  281.         "profile_sidebar_border_color": "eeeeee",
  282.         "profile_background_tile": true,
  283.         "profile_sidebar_fill_color": "efefef",
  284.         "expanded_url": null,
  285.         "created_at": "Wed Nov 05 23:08:20 +0000 2008",
  286.         "profile_image_url": "http://a0.twimg.com/profile_images/582423908/IMG_3383_normal.jpg",
  287.         "location": "25.779824,-80.135872",
  288.         "follow_request_sent": false,
  289.         "id_str": "17200032",
  290.         "profile_link_color": "009999",
  291.         "is_translator": false,
  292.         "entities": {
  293.           "urls": [
  294.  
  295.           ],
  296.           "hashtags": [
  297.  
  298.           ],
  299.           "user_mentions": [
  300.  
  301.           ]
  302.         },
  303.         "favourites_count": 5,
  304.         "contributors_enabled": true,
  305.         "url": null,
  306.         "utc_offset": -18000,
  307.         "id": 17200032,
  308.         "profile_use_background_image": true,
  309.         "listed_count": 6,
  310.         "lang": "en",
  311.         "followers_count": 301,
  312.         "protected": false,
  313.         "profile_text_color": "333333",
  314.         "profile_background_color": "131516",
  315.         "geo_enabled": true,
  316.         "verified": false,
  317.         "time_zone": "Eastern Time (US & Canada)",
  318.         "description": "Entrepreneur, surfer, photographer, Twitter Advertising",
  319.         "notifications": false,
  320.         "friends_count": 618,
  321.         "display_url": null,
  322.         "statuses_count": 841,
  323.         "profile_background_image_url": "http://a2.twimg.com/a/1295464831/images/themes/theme14/bg.gif",
  324.         "show_all_inline_media": true,
  325.         "screen_name": "hsunmav",
  326.         "following": false
  327.       },
  328.       "source": "<a href=\"http://twitter.com/tweetbutton\" rel=\"nofollow\">Tweet Button</a>",
  329.       "place": null,
  330.       "in_reply_to_status_id": null
  331.     },
  332.     "in_reply_to_user_id_str": null,
  333.     "contributors": null,
  334.     "annotations": null,
  335.     "text": "RT @hsunmav: According to @techcrunch, Twitter is #1 referrer in 2010!  http://t.co/YBokP0g",
  336.     "id": 29942603927519235,
  337.     "retweet_count": 0,
  338.     "in_reply_to_status_id_str": null,
  339.     "geo": null,
  340.     "retweeted": false,
  341.     "in_reply_to_user_id": null,
  342.     "in_reply_to_screen_name": null,
  343.     "user": {
  344.       "name": "Kelton Lynn",
  345.       "profile_sidebar_border_color": "38301f",
  346.       "profile_background_tile": false,
  347.       "profile_sidebar_fill_color": "38301f",
  348.       "expanded_url": null,
  349.       "created_at": "Mon Mar 30 16:30:42 +0000 2009",
  350.       "profile_image_url": "http://a3.twimg.com/profile_images/384067053/n209356_35266280_356207_2_normal.jpg",
  351.       "location": "23.010768,-109.721906",
  352.       "follow_request_sent": false,
  353.       "id_str": "27674040",
  354.       "profile_link_color": "9e9070",
  355.       "is_translator": false,
  356.       "entities": {
  357.         "urls": [
  358.  
  359.         ],
  360.         "hashtags": [
  361.  
  362.         ],
  363.         "user_mentions": [
  364.  
  365.         ]
  366.       },
  367.       "favourites_count": 20,
  368.       "contributors_enabled": false,
  369.       "url": null,
  370.       "utc_offset": -28800,
  371.       "id": 27674040,
  372.       "profile_use_background_image": true,
  373.       "listed_count": 84,
  374.       "lang": "en",
  375.       "followers_count": 2034,
  376.       "protected": false,
  377.       "profile_text_color": "6e624b",
  378.       "profile_background_color": "38301f",
  379.       "geo_enabled": true,
  380.       "verified": false,
  381.       "time_zone": "Pacific Time (US & Canada)",
  382.       "description": "Mobile BizDev at Twitter, former Boulderite, bleed Cardinal, SF transplant, love athletics/competition, consumer tech, entrepreneurship, family/friends...life",
  383.       "notifications": false,
  384.       "friends_count": 633,
  385.       "display_url": null,
  386.       "statuses_count": 1246,
  387.       "profile_background_image_url": "http://a0.twimg.com/profile_background_images/105179201/boulder_181_10949.jpg",
  388.       "show_all_inline_media": true,
  389.       "screen_name": "keltonlynn",
  390.       "following": true
  391.     },
  392.     "source": "<a href=\"http://twitter.com/\" rel=\"nofollow\">Twitter for iPhone</a>",
  393.     "place": null,
  394.     "in_reply_to_status_id": null
  395.   }
  396. ]