GET statuses/retweets/:id

API version 1
Updated on Wed, 2012-04-18 10:37

Returns up to 100 of the first retweets of a given tweet.

Resource URL

http://api.twitter.com/1/statuses/retweets/:id.format

Parameters

id required

The numerical ID of the desired status.

Example Values: 123

count optional

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

Example Values: 5

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/retweets/21947795900469248.json 

  1. [
  2.   {
  3.     "coordinates": null,
  4.     "truncated": false,
  5.     "created_at": "Mon Jan 03 15:17:31 +0000 2011",
  6.     "favorited": false,
  7.     "retweeted_status": {
  8.       "coordinates": null,
  9.       "truncated": false,
  10.       "created_at": "Mon Jan 03 15:15:36 +0000 2011",
  11.       "favorited": false,
  12.       "id_str": "21947795900469248",
  13.       "in_reply_to_user_id_str": null,
  14.       "annotations": null,
  15.       "contributors": null,
  16.       "text": "It's 2011. I work at Twitter. And so let's go kick some ass.",
  17.       "id": 21947795900469248,
  18.       "retweet_count": 1,
  19.       "in_reply_to_status_id_str": null,
  20.       "geo": null,
  21.       "retweeted": false,
  22.       "in_reply_to_user_id": null,
  23.       "user": {
  24.         "name": "Taylor Singletary",
  25.         "profile_background_tile": false,
  26.         "profile_sidebar_fill_color": "000b17",
  27.         "expanded_url": "http://bit.ly/5w7P88",
  28.         "profile_sidebar_border_color": "f7b565",
  29.         "location": "iPhone: 37.778189,-122.397936",
  30.         "profile_image_url": "http://a3.twimg.com/profile_images/1208696313/3eyed_normal.gif",
  31.         "created_at": "Wed Mar 07 22:23:19 +0000 2007",
  32.         "profile_link_color": "448668",
  33.         "is_translator": false,
  34.         "id_str": "819797",
  35.         "follow_request_sent": false,
  36.         "entities": {
  37.           "urls": [
  38.  
  39.           ],
  40.           "hashtags": [
  41.  
  42.           ],
  43.           "user_mentions": [
  44.  
  45.           ]
  46.         },
  47.         "favourites_count": 1873,
  48.         "url": "http://t.co/dapZGV0",
  49.         "contributors_enabled": false,
  50.         "utc_offset": -28800,
  51.         "id": 819797,
  52.         "listed_count": 189,
  53.         "profile_use_background_image": true,
  54.         "protected": false,
  55.         "followers_count": 2677,
  56.         "profile_text_color": "004358",
  57.         "lang": "en",
  58.         "time_zone": "Pacific Time (US & Canada)",
  59.         "geo_enabled": true,
  60.         "verified": false,
  61.         "notifications": false,
  62.         "profile_background_color": "001329",
  63.         "description": "Reality Technician, Developer Advocate at Twitter, .:",
  64.         "friends_count": 2227,
  65.         "display_url": "bit.ly/5w7P88",
  66.         "profile_background_image_url": "http://a1.twimg.com/profile_background_images/174206644/nasa9_792_31420.jpg",
  67.         "statuses_count": 8925,
  68.         "show_all_inline_media": true,
  69.         "screen_name": "episod",
  70.         "following": false
  71.       },
  72.       "source": "<a href=\"http://sites.google.com/site/yorufukurou/\" rel=\"nofollow\">YoruFukurou</a>",
  73.       "place": null,
  74.       "in_reply_to_screen_name": null,
  75.       "in_reply_to_status_id": null
  76.     },
  77.     "id_str": "21948274806095872",
  78.     "in_reply_to_user_id_str": null,
  79.     "annotations": null,
  80.     "contributors": null,
  81.     "text": "RT @episod: It's 2011. I work at Twitter. And so let's go kick some ass.",
  82.     "id": 21948274806095872,
  83.     "retweet_count": 1,
  84.     "in_reply_to_status_id_str": null,
  85.     "geo": null,
  86.     "retweeted": false,
  87.     "in_reply_to_user_id": null,
  88.     "user": {
  89.       "name": "Keef M",
  90.       "profile_background_tile": false,
  91.       "profile_sidebar_fill_color": "9fbac9",
  92.       "profile_sidebar_border_color": "303030",
  93.       "location": "51.525875,-0.082909",
  94.       "profile_image_url": "http://a2.twimg.com/profile_images/1095477108/image_normal.jpg",
  95.       "created_at": "Thu Mar 22 15:35:51 +0000 2007",
  96.       "profile_link_color": "0b57a1",
  97.       "is_translator": false,
  98.       "id_str": "1891481",
  99.       "follow_request_sent": false,
  100.       "favourites_count": 749,
  101.       "url": "http://www.dataninjitsu.com",
  102.       "contributors_enabled": false,
  103.       "utc_offset": 0,
  104.       "id": 1891481,
  105.       "listed_count": 36,
  106.       "profile_use_background_image": true,
  107.       "protected": false,
  108.       "followers_count": 835,
  109.       "profile_text_color": "303030",
  110.       "lang": "en",
  111.       "time_zone": "London",
  112.       "geo_enabled": true,
  113.       "verified": false,
  114.       "notifications": false,
  115.       "profile_background_color": "303030",
  116.       "description": "Tech and gadget enthusiast. iOS Developer with @mobileroadie",
  117.       "friends_count": 1367,
  118.       "profile_background_image_url": "http://a3.twimg.com/profile_background_images/64877359/mqglacierlake.br.jpg",
  119.       "statuses_count": 9612,
  120.       "show_all_inline_media": false,
  121.       "screen_name": "keefmoon",
  122.       "following": true
  123.     },
  124.     "source": "web",
  125.     "place": null,
  126.     "in_reply_to_screen_name": null,
  127.     "in_reply_to_status_id": null
  128.   }
  129. ]