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_of_me¶
Returns the most recent Tweets authored by the authenticating user that have been retweeted by others. This timeline is a subset of the user’s GET statuses / user_timeline.
Resource URL¶
https://api.twitter.com/1.1/statuses/retweets_of_me.json
Resource Information¶
Response formats | JSON |
Requires authentication? | Yes (user context only) |
Rate limited? | Yes |
Requests / 15-min window (user auth) | 75 |
Parameters¶
Name | Required | Description | Default Value | Example |
count | optional | Specifies the number of records to retrieve. Must be less than or equal to 100. If omitted, 20 will be assumed. | 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. | 12345 | |
max_id | optional | Returns results with an ID less than (that is, older than) or equal to the specified ID. | 54321 | |
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 | |
include_entities | optional | The tweet entities node will not be included when set to false . | false | |
include_user_entities | optional | The user entities node will not be included when set to false . | false |
Example Request¶
GET https://api.twitter.com/1.1/statuses/retweets_of_me.json?count=50&since_id=259320959964680190&max_id=259320959964680500
Example Response¶
[
{
"coordinates": null,
"truncated": false,
"favorited": false,
"created_at": "Fri Oct 19 15:51:49 +0000 2012",
"id_str": "259320959964680192",
"entities": {
"urls": [
],
"hashtags": [
],
"user_mentions": [
]
},
"in_reply_to_user_id_str": null,
"contributors": null,
"text": "It's bring your migraine to work day today!",
"in_reply_to_status_id_str": null,
"id": 259320959964680192,
"retweet_count": 1,
"geo": null,
"retweeted": false,
"in_reply_to_user_id": null,
"source": "YoruFukurou",
"user": {
"name": "Taylor Singletary",
"profile_sidebar_fill_color": "FBFBFB",
"profile_background_tile": false,
"profile_sidebar_border_color": "000000",
"location": "San Francisco, CA",
"profile_image_url": "http://a0.twimg.com/profile_images/2766969649/5e1a50995a9f9bfcdcdc7503e1271422_normal.jpeg",
"created_at": "Wed Mar 07 22:23:19 +0000 2007",
"profile_link_color": "CC1442",
"is_translator": false,
"id_str": "819797",
"follow_request_sent": false,
"entities": {
"url": {
"urls": [
{
"expanded_url": "http://soundcloud.com/reality-technician",
"url": "http://t.co/bKlJ80Do",
"indices": [
0,
20
],
"display_url": "soundcloud.com/reality-techni…"
}
]
},
"description": {
"urls": [
]
}
},
"favourites_count": 17094,
"url": "http://t.co/bKlJ80Do",
"contributors_enabled": false,
"default_profile": false,
"profile_image_url_https": "https://si0.twimg.com/profile_images/2766969649/5e1a50995a9f9bfcdcdc7503e1271422_normal.jpeg",
"profile_banner_url": "https://si0.twimg.com/profile_banners/819797/1351262715",
"utc_offset": -28800,
"id": 819797,
"profile_use_background_image": false,
"listed_count": 351,
"followers_count": 7701,
"profile_text_color": "D20909",
"protected": false,
"lang": "en",
"geo_enabled": true,
"time_zone": "Pacific Time (US & Canada)",
"notifications": false,
"profile_background_color": "6B0F0F",
"description": "Reality Technician, Twitter API team, synth enthusiast. A most excellent adventure in timelines. Through the darkness of future past, the magician longs to see.",
"verified": false,
"profile_background_image_url_https": "https://si0.twimg.com/profile_background_images/686878932/6447abb9f83c76fb4fbd68e626c6c8c1.png",
"friends_count": 5549,
"default_profile_image": false,
"profile_background_image_url": "http://a0.twimg.com/profile_background_images/686878932/6447abb9f83c76fb4fbd68e626c6c8c1.png",
"statuses_count": 18626,
"screen_name": "episod",
"following": false
},
"place": null,
"in_reply_to_screen_name": null,
"in_reply_to_status_id": null
}
]