POST statuses/retweet/:id

API version 1
Updated on Wed, 2012-04-18 10:39
Retweets a tweet. Returns the original tweet with retweet details embedded.

Resource URL

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

Parameters

id required

The numerical ID of the desired status.

Example Values: 123

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

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

Extended description

Usage Notes:

  • This method is subject to update limits. A HTTP 403 will be returned if this limit as been hit.
  • Twitter will ignore attempts to perform duplicate retweets.
  • The retweet_count will be current as of when the payload is generated and may not reflect the exact count. It is intended as an approximation. [COMING SOON]
  • Twitter will ignore attempts to retweet your own tweets.

Example Request

POST

http://api.twitter.com/1/statuses/retweet/3962807808.json

POST Data

None 

  1. {
  2.   "coordinates": null,
  3.   "favorited": false,
  4.   "truncated": false,
  5.   "created_at": "Tue Jan 11 23:10:48 +0000 2011",
  6.   "id_str": "24966484103004160",
  7.   "retweeted_status": {
  8.     "coordinates": null,
  9.     "favorited": false,
  10.     "truncated": false,
  11.     "created_at": "Tue Jan 11 19:48:03 +0000 2011",
  12.     "id_str": "24915460449370112",
  13.     "in_reply_to_user_id_str": null,
  14.     "contributors": null,
  15.     "annotations": null,
  16.     "text": "Do you know somebody that runs algorithms on millions of tweets everyday but doesn't have a Twitter account of their own? I do.",
  17.     "id": 24915460449370112,
  18.     "in_reply_to_status_id_str": null,
  19.     "retweet_count": 2,
  20.     "geo": null,
  21.     "retweeted": false,
  22.     "in_reply_to_user_id": null,
  23.     "in_reply_to_screen_name": null,
  24.     "user": {
  25.       "name": "Abraham Williams",
  26.       "profile_sidebar_border_color": "12BEF2",
  27.       "profile_background_tile": false,
  28.       "profile_sidebar_fill_color": "ffffff",
  29.       "profile_image_url": "http://a3.twimg.com/profile_images/1117369624/new-border_normal.png",
  30.       "location": "San Francisco",
  31.       "created_at": "Sun Oct 14 12:50:47 +0000 2007",
  32.       "follow_request_sent": false,
  33.       "id_str": "9436992",
  34.       "profile_link_color": "33ccff",
  35.       "is_translator": false,
  36.       "contributors_enabled": false,
  37.       "favourites_count": 1062,
  38.       "url": "http://abrah.am/?src=twt",
  39.       "utc_offset": -28800,
  40.       "id": 9436992,
  41.       "profile_use_background_image": false,
  42.       "listed_count": 372,
  43.       "protected": false,
  44.       "followers_count": 2782,
  45.       "profile_text_color": "454545",
  46.       "lang": "en",
  47.       "profile_background_color": "ffffff",
  48.       "notifications": false,
  49.       "geo_enabled": true,
  50.       "time_zone": "Pacific Time (US & Canada)",
  51.       "verified": false,
  52.       "description": "Hacker Advocate working at @answerly looking for awesome people/projects. Mainiac and perfectionist with interestes in #google #twitter #apis. Built @oauthlib",
  53.       "friends_count": 490,
  54.       "profile_background_image_url": "http://a0.twimg.com/profile_background_images/63275387/White_Crystal.jpg",
  55.       "statuses_count": 20869,
  56.       "show_all_inline_media": true,
  57.       "following": true,
  58.       "screen_name": "abraham"
  59.     },
  60.     "source": "<a href=\"http://itunes.apple.com/us/app/twitter/id409789998?mt=12\" rel=\"nofollow\">Twitter for Mac</a>",
  61.     "place": null,
  62.     "in_reply_to_status_id": null
  63.   },
  64.   "in_reply_to_user_id_str": null,
  65.   "contributors": null,
  66.   "annotations": null,
  67.   "text": "RT @abraham: Do you know somebody that runs algorithms on millions of tweets everyday but doesn't have a Twitter account of their own? I do.",
  68.   "id": 24966484103004160,
  69.   "in_reply_to_status_id_str": null,
  70.   "retweet_count": 2,
  71.   "geo": null,
  72.   "retweeted": false,
  73.   "in_reply_to_user_id": null,
  74.   "in_reply_to_screen_name": null,
  75.   "user": {
  76.     "expanded_url": "http://bit.ly/5w7P88",
  77.     "name": "Taylor Singletary",
  78.     "profile_sidebar_border_color": "f7b565",
  79.     "profile_background_tile": false,
  80.     "profile_sidebar_fill_color": "000b17",
  81.     "profile_image_url": "http://a3.twimg.com/profile_images/1208696313/3eyed_normal.gif",
  82.     "location": "iPhone: 37.778189,-122.397936",
  83.     "created_at": "Wed Mar 07 22:23:19 +0000 2007",
  84.     "follow_request_sent": false,
  85.     "id_str": "819797",
  86.     "profile_link_color": "448668",
  87.     "is_translator": false,
  88.     "entities": {
  89.       "urls": [
  90.  
  91.       ],
  92.       "hashtags": [
  93.  
  94.       ],
  95.       "user_mentions": [
  96.  
  97.       ]
  98.     },
  99.     "contributors_enabled": false,
  100.     "favourites_count": 1894,
  101.     "url": "http://t.co/dapZGV0",
  102.     "utc_offset": -28800,
  103.     "id": 819797,
  104.     "profile_use_background_image": true,
  105.     "listed_count": 189,
  106.     "protected": false,
  107.     "followers_count": 2687,
  108.     "profile_text_color": "004358",
  109.     "lang": "en",
  110.     "profile_background_color": "001329",
  111.     "notifications": false,
  112.     "geo_enabled": true,
  113.     "time_zone": "Pacific Time (US & Canada)",
  114.     "verified": false,
  115.     "description": "Reality Technician, Developer Advocate at Twitter, .:",
  116.     "friends_count": 2233,
  117.     "display_url": "bit.ly/5w7P88",
  118.     "profile_background_image_url": "http://a1.twimg.com/profile_background_images/174206644/nasa9_792_31420.jpg",
  119.     "statuses_count": 8947,
  120.     "show_all_inline_media": true,
  121.     "following": false,
  122.     "screen_name": "episod"
  123.   },
  124.   "source": "<a href=\"http://realitytechnicians.com\" rel=\"nofollow\">Crying Indian</a>",
  125.   "place": null,
  126.   "in_reply_to_status_id": null
  127. }