Post, retrieve and engage with Tweets
API Reference contents
POST statuses/update
POST statuses/destroy/:id
GET statuses/show/:id
GET statuses/oembed
GET statuses/lookup
POST statuses/retweet/:id
POST statuses/unretweet/:id
GET statuses/retweets/:id
GET statuses/retweets_of_me
GET statuses/retweeters/ids
POST favorites/create
POST favorites/destroy
GET favorites/list
POST statuses/update_with_media (deprecated)
GET statuses/retweets/:id¶
Returns a collection of the 100 most recent retweets of the Tweet specified by the id
parameter.
Resource URL¶
https://api.twitter.com/1.1/statuses/retweets/:id.json
Resource Information¶
Response formats | JSON |
Requires authentication? | Yes |
Rate limited? | Yes |
Requests / 15-min window (user auth) | 75 |
Requests / 15-min window (app auth) | 300 |
Parameters¶
Name | Required | Description | Default Value | Example |
id | required | The numerical ID of the desired status. | 123 | |
count | optional | Specifies the number of records to retrieve. Must be less than or equal to 100. | 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. | true |
Example Request¶
GET https://api.twitter.com/1.1/statuses/retweets/509457288717819904.json
Example Response¶
[
{
"contributors": null,
"coordinates": null,
"created_at": "Tue Sep 09 23:44:05 +0000 2014",
"entities": {
"hashtags": [],
"symbols": [],
"urls": [],
"user_mentions": [
{
"id": 56223278,
"id_str": "56223278",
"indices": [
3,
13
],
"name": "David Muir",
"screen_name": "DavidMuir"
}
]
},
"favorite_count": 0,
"favorited": false,
"geo": null,
"id": 509487438688186400,
"id_str": "509487438688186368",
"in_reply_to_screen_name": null,
"in_reply_to_status_id": null,
"in_reply_to_status_id_str": null,
"in_reply_to_user_id": null,
"in_reply_to_user_id_str": null,
"lang": "en",
"place": null,
"retweet_count": 238,
"retweeted": false,
"retweeted_status": {
"contributors": null,
"coordinates": null,
"created_at": "Tue Sep 09 21:44:17 +0000 2014",
"entities": {
"hashtags": [],
"symbols": [],
"urls": [],
"user_mentions": []
},
"favorite_count": 477,
"favorited": false,
"geo": null,
"id": 509457288717819900,
"id_str": "509457288717819904",
"in_reply_to_screen_name": null,
"in_reply_to_status_id": null,
"in_reply_to_status_id_str": null,
"in_reply_to_user_id": null,
"in_reply_to_user_id_str": null,
"lang": "en",
"place": null,
"retweet_count": 238,
"retweeted": false,
"source": "<a href="http://twitter.com" rel="nofollow">Twitter for iPhone</a>",
"text": "How fun to send the first tweet ever from an Apple Watch. See you tonight.",
"truncated": false,
"user": {
"contributors_enabled": false,
"created_at": "Sun Jul 12 23:31:43 +0000 2009",
"default_profile": false,
"default_profile_image": false,
"description": "Anchor, ABC World News Tonight with David Muir; Co-Anchor, '20/20'",
"entities": {
"description": {
"urls": []
},
"url": {
"urls": [
{
"display_url": "facebook.com/davidmuirabc",
"expanded_url": "http://www.facebook.com/davidmuirabc",
"indices": [
0,
22
],
"url": "http://t.co/DGu4Ogey6V"
}
]
}
},
"favourites_count": 8,
"follow_request_sent": null,
"followers_count": 139507,
"following": null,
"friends_count": 970,
"geo_enabled": false,
"id": 56223278,
"id_str": "56223278",
"is_translation_enabled": false,
"is_translator": false,
"lang": "en",
"listed_count": 1667,
"location": "New York",
"name": "David Muir",
"notifications": null,
"profile_background_color": "212020",
"profile_background_image_url": "http://pbs.twimg.com/profile_background_images/313947201/dmtwitter.jpg",
"profile_background_image_url_https": "https://pbs.twimg.com/profile_background_images/313947201/dmtwitter.jpg",
"profile_background_tile": false,
"profile_banner_url": "https://pbs.twimg.com/profile_banners/56223278/1404516993",
"profile_image_url": "http://pbs.twimg.com/profile_images/1341313885/twit3_normal.jpg",
"profile_image_url_https": "https://pbs.twimg.com/profile_images/1341313885/twit3_normal.jpg",
"profile_link_color": "0084B4",
"profile_sidebar_border_color": "46495C",
"profile_sidebar_fill_color": "DDEEF6",
"profile_text_color": "333333",
"profile_use_background_image": true,
"protected": false,
"screen_name": "DavidMuir",
"statuses_count": 4705,
"time_zone": "Eastern Time (US & Canada)",
"url": "http://t.co/DGu4Ogey6V",
"utc_offset": -14400,
"verified": true
}
},
"source": "<a href="http://twitter.com/download/iphone" rel="nofollow">Twitter for iPhone</a>",
"text": "RT @DavidMuir: How fun to send the first tweet ever from an Apple Watch. See you tonight.",
"truncated": false,
"user": {
"contributors_enabled": false,
"created_at": "Wed Apr 13 19:12:33 +0000 2011",
"default_profile": true,
"default_profile_image": false,
"description": "Producer, ABC News",
"entities": {
"description": {
"urls": []
}
},
"favourites_count": 9,
"follow_request_sent": null,
"followers_count": 936,
"following": null,
"friends_count": 316,
"geo_enabled": true,
"id": 281679947,
"id_str": "281679947",
"is_translation_enabled": false,
"is_translator": false,
"lang": "en",
"listed_count": 43,
"location": "NYC",
"name": "Christine Romo",
"notifications": null,
"profile_background_color": "C0DEED",
"profile_background_image_url": "http://abs.twimg.com/images/themes/theme1/bg.png",
"profile_background_image_url_https": "https://abs.twimg.com/images/themes/theme1/bg.png",
"profile_background_tile": false,
"profile_banner_url": "https://pbs.twimg.com/profile_banners/281679947/1399243210",
"profile_image_url": "http://pbs.twimg.com/profile_images/463087778893275136/TKIzZxN7_normal.jpeg",
"profile_image_url_https": "https://pbs.twimg.com/profile_images/463087778893275136/TKIzZxN7_normal.jpeg",
"profile_link_color": "0084B4",
"profile_sidebar_border_color": "C0DEED",
"profile_sidebar_fill_color": "DDEEF6",
"profile_text_color": "333333",
"profile_use_background_image": true,
"protected": false,
"screen_name": "romoabcnews",
"statuses_count": 667,
"time_zone": null,
"url": null,
"utc_offset": null,
"verified": false
}
}
]